Exemple StringUtilities

L'exemple StringUtilities contient une fonction table en continu écrite en Visual C# et Visual Basic qui fractionne une chaîne séparée par des virgules en une table avec une colonne. Il contient également une fonction d'agrégation qui convertit une colonne de chaîne en une chaîne séparée par des virgules.

Les fichiers sources concat.cs et concat.vb contiennent l'implémentation de la fonction d'agrégation. Les fichiers source split.cs et split.vb contiennent l'implémentation de la fonction table en continu. Les fichiers source RegularExpression.cs et RegularExpression.vb mettent en œuvre une fonction scalaire et une fonction table qui assurent une fonctionnalité de recherche et de remplacement d'expressions régulières.

Pour implémenter une fonction table en continu, créez une méthode qui retourne un objet mettant en œuvre l'interface IEnumerable. Cette méthode IEnumerable doit être liée par un attribut à une autre méthode qui remplit les lignes de la fonction table.

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

Scénario

Un développeur souhaite créer une fonction qui retourne une table de valeurs en diffusant ces valeurs à l'appelant.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

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

Domaine d'application	Fonctionnalités
Global	CLR (Common Language Runtime)

Configuration requise

Avant d'exécuter cet exemple, assurez-vous que les logiciels suivants sont installés :

• SQL Server 2005 ou SQL Server 2005 Express Edition (SQL Server Express). Vous pouvez obtenir SQL Server Express gratuitement à partir du site Web SQL Server 2005 Express Edition Documentation et exemples.
• 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. Consultez Installation du SDK .NET Framework.

Génération de l'exemple

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

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.

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, livré avec 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\StringUtilities.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, à l'invite de commandes, une commande semblable à celle-ci :

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

   Ce fichier contient le script nécessaire à l'installation et à l'inscription des exemples d'objets CLR dans SQL Server.

Exécution de l'exemple

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

Exécution de l'exemple

1. Ouvrez le fichier scripts\test.sql dans Management Studio et exécutez le script que contient le fichier. Vous pouvez également exécuter la commande suivante à l'invite de commandes :

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

   Ce script illustre les principales façons d'utiliser l'exemple.

Suppression de l'exemple

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

Suppression de l'exemple

1. Ouvrez le fichier scripts\cleanup.sql dans Management Studio et exécutez le script que contient le fichier. Vous pouvez également exécuter la commande suivante à 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 de SQL Server 2005 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 2005

Historique des modifications

Version	Historique
5 décembre 2005	Contenu modifié : Modification des instructions concernant la génération d'un fichier de clé, y compris le nom et l'emplacement de ce fichier.
17 juillet 2006	Contenu modifié : Correction des instructions de génération et insertion de l'expression manquante.