Fichier Lisezmoi pour l’exemple XmlOnlineCatalog

  • Article

[Cette rubrique est une documentation préliminaire susceptible d'être modifiée dans les versions ultérieures. Les rubriques vierges sont incluses comme espaces réservés. REMARQUE : Afin de vous donner accès à des contenus toujours plus nombreux en langue française, Microsoft met à votre disposition des articles et de la documentation dont la traduction a pu être réalisée en utilisant des outils et méthodes spécifiques, et notamment grâce à l’utilisation d’un système de traduction automatique. La traduction d’une partie du contenu de la documentation de cette version préliminaire a fait appel à l’utilisation de telles méthodes. Nous sommes conscients que certains contenus ainsi traduits peuvent contenir des erreurs de vocabulaire, de syntaxe ou de grammaire. La version finale de ce contenu sera traduite à l’aide de méthodes traditionnelles, ce qui permettra de garantir un niveau de qualité comparable à celui des versions précédentes.]

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 2005.

L'exemple d'application XMLOnlineCatalog affiche des informations sur des produits particuliers. Cet exemple récupère des informations des colonnes suivantes de la base de données SQL Server AdventureWorks2008R2 :

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

Le répertoire d'installation par défaut est C:\Program Files\Microsoft SQL Server\100\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 récupérer 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 :

Domaine d'application Fonctionnalités

Général

XML, services Web hébergés par SQL Server

Configuration requise

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

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.

    Notes

    Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur 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

    Notes

    Pour plus d'informations sur la paire de clés avec nom fort, consultez « Security Briefs: Strong Names and Security in the .NET Framework » (en anglais) dans le Centre de Développement du .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 AdventureWorks2008R2 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, 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 du catalogue 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 2008 R2