Readme_XmlOnlineCatalog

Mis à jour : 5 décembre 2005

L'exemple d'application XMLOnlineCatalog affiche des informations sur des produits particuliers. Cet exemple extrait des informations des colonnes suivantes de la base de données SQL Server AdventureWorks :

• Colonne de type xml CatalogDescription de la table Production.ProductModel
• Colonne LargePhoto de la table Production.ProductPhoto

Cet exemple n'est pas pris en charge sur Windows 2000 et les systèmes d'exploitation antérieurs.

Le répertoire d'installation par défaut est lecteur:\Program Files\Microsoft SQL Server\90\Samples\Engine\XML\XmlOnlineCatalog.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Scénario

Un développeur veut extraire des descriptions de produits en XML à partir d'un service Web hébergé par SQL Server.

Langages

Transact-SQL, XML, XSD, XSLT, Visual C# et Visual Basic.

Fonctionnalités

L'exemple XmlOnlineCatalog utilise les fonctionnalités suivantes de SQL Server 2005 :

Configuration requise

Avant d'exécuter cet exemple, vérifiez que le logiciel suivant est installé :

• SQL Server 2005 ou SQL Server 2005 Express Edition. Vous pouvez obtenir SQL Server Express gratuitement à partir du site Web de téléchargement de SQL Server Express.
• Base de données AdventureWorks fournie avec SQL Server 2005 et également disponible sur le site Web du SQL Server Developer Center (Centre des développeurs SQL Server).
• Les exemples du moteur de base de données SQL Server 2005. Ces exemples accompagnent SQL Server 2005. Vous pouvez télécharger la dernière version des exemples sur le site Web du SQL Server Developer Center (Centre des développeurs SQL Server).
• Le Kit de développement .NET Framework SDK 2.0 ou Microsoft Visual Studio 2005. Vous pouvez obtenir gratuitement le Kit de développement .NET Framework SDK. Pour plus d'informations, consultez Installation du SDK .NET Framework.

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

   -- Ou --

   Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

   Remarque :

   Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

   sn -k SampleKey.snk

   Important :
   Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Pour générer l'exemple, procédez comme suit :

Pour générer l'exemple

1. Vérifiez que la base de données exemple AdventureWorks est installée.

2. Dans SQL Server Management Studio, chargez et exécutez le script scripts\install.sql ou exécutez la commande suivante à l'invite de commandes :

   sqlcmd -E -I -i Scripts\install.sql

   Ce script crée les éléments suivants :

   • La procédure stockée GetProductDescription
   • Le point de terminaison HTTP sql_ProductCatalog

3. Dans l'Explorateur Windows, cliquez avec le bouton droit sur le dossier CS\XmlOnlineCatalog où l'exemple a été installé, cliquez successivement sur Propriétés, sur l'onglet Partage Web, sur l'option Partager ce dossier, puis sur OK à deux reprises. Vous créez ainsi pour l'exemple un dossier virtuel IIS qui permettra à l'application de fonctionner correctement.

4. Compilez l'application à l'aide de la solution Microsoft Visual Studio fournie, ou exécutez la commande suivante à une invite de commandes de .NET Framework ou de Microsoft Visual Studio 2005 :

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ xmlonlinecatalog.sln

Exécution de l'exemple

Pour exécuter l'exemple, procédez comme suit :

Pour exécuter l'exemple

1. Exécutez l'application CS\XmlOnlineCatalog\bin\debug\XmlOnlineCatalog.exe.

2. Entrez 19 comme valeur de ProductModelID et cliquez sur Show Description. Pour obtenir des informations sur le format de la demande SOAP, cliquez sur Show Request. Pour obtenir des informations sur le format de la réponse SOAP de SQL Server 2005, cliquez sur Show Response. Pour obtenir des informations sur le fichier XSLT utilisé pour rendre les instructions, cliquez sur Show XSL. Vous pouvez rechercher dans la table ProductModel d'autres valeurs de ProductModelID pour lesquelles des descriptions de produits en XML sont stockées.

Suppression de l'exemple

Pour supprimer l'exemple, procédez comme suit :

Pour supprimer l'exemple

1. Ouvrez le fichier Scripts\Cleanup.sql à l'aide de SQL Server Management Studio et exécutez le contenu du fichier. Vous pouvez également exécuter la commande suivante à l'invite de commandes :

   sqlcmd -E -I -i Scripts\cleanup.sql

Commentaires

Voir aussi

Concepts

Exemples XML

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications