Partager via

Exemple Readme_UDT Utilities

  • Article

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 UDTUtilities contient diverses fonctions utilitaires, notamment des fonctions pour afficher les métadonnées d'un assembly dans Transact-SQL, des exemples de fonctions table en continu pour retourner les types dans un assembly sous forme de table, et enfin des fonctions pour retourner les champs, méthodes et propriétés dans un type défini par l'utilisateur. Les technologies illustrées comprennent les fonctions table en continu, les API de réflexion du .NET Framework et l'appel des fonctions table à partir de Transact-SQL.

Lorsque vous compilez les exemples d'intégration du CLR (Common Language Runtime), notez que le chemin d'accès de la version du compilateur Microsoft .NET Framework disponible dans SQL Server doit correspondre au premier répertoire Framework figurant dans la variable d'environnement PATH. L'emplacement du compilateur fourni avec SQL Server est lecteur:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx ou lecteur:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, où lecteur désigne le lecteur d'installation et xxxxx la version du .NET Framework livrée avec votre copie de SQL Server.

Le répertoire d'installation par défaut est C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\UDTUtilities.

Les exemples SQL Server et les exemples de bases de données doivent être téléchargés et installés avant que vous ne puissiez les afficher ou les utiliser. Pour plus d'informations, consultez Considérations relatives à l'installation d'exemples de bases de données et d'exemples de code SQL Server.

Scénario

Un développeur souhaite accéder aux métadonnées concernant des types de données définis par l'utilisateur basés sur le Common Language Runtime.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

L'exemple UDTUtilities emploie les fonctionnalités SQL Server suivantes :

Domaine d'application Fonctionnalités

Général

CLR

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.

    ms160746.note(fr-fr,SQL.100).gifRemarque :
    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

    ms160746.note(fr-fr,SQL.100).gifImportant :
    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 :

Génération de l'exemple

  1. Compilez l'exemple au moyen de Visual Studio 2005 et de la solution Visual Studio fournie, ou à l'aide de Microsoft MSBuild disponible dans le Kit de développement logiciel .NET Framework SDK 2.0. À partir de l'invite de commandes, exécutez une commande semblable à celle-ci :

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

  2. Assurez-vous que la base de données AdventureWorks est installée ou, si nécessaire, créez la base de données dans laquelle vous souhaitez installer les exemples.

  3. Ouvrez le fichier scripts\installCS.sql ou scripts\installVB.sql, selon que vous avez compilé le projet Visual C# ou Visual Basic, dans SQL Server Management Studio. Exécutez le script contenu dans le fichier ou exécutez une commande semblable à la suivante à l'invite de commandes :

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

    Ce fichier contient le script permettant d'installer et d'inscrire les exemples de fonctions utilitaires dans SQL Server.

Exécution de l'exemple

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

Pour exécuter l'exemple

  1. Ouvrez le fichier scripts\test.sql dans Management Studio. Exécutez le script contenu dans le fichier ou la commande suivante à partir de l'invite de commandes :

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

    Ce script appelle les objets de l'exemple à partir de Transact-SQL.

Suppression de l'exemple

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

Pour supprimer l'exemple

  1. Ouvrez le fichier scripts\cleanup.sql dans Management Studio. Exécutez le script contenu dans le fichier ou la commande suivante à partir de l'invite de commandes :

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

    Ce script supprime l'exemple.

Commentaires

Pour que cet exemple fonctionne correctement, le CLR pour SQL Server ou SQL Server Express doit être activé.

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.

Voir aussi

Concepts

Exemples de programmabilité CLR

Aide et informations

Assistance sur SQL Server 2008