Manipulation de chaînes sensible aux caractères supplémentaires

Mis à jour : 5 décembre 2005

L'exemple StringManipulate pour Microsoft SQL Server 2005 illustre un traitement de chaînes sensible aux caractères supplémentaires. Cet exemple illustre l'implémentation de cinq fonctions de chaîne Transact-SQL qui procurent les mêmes fonctions de manipulation de chaînes que les fonctions intégrées, mais avec une capacité additionnelle autorisant la gestion des chaînes de caractères Unicode et supplémentaires. Les cinq fonctions sont len_s(), left_s(), right_s(), sub_s() et replace_s(), qui sont équivalentes aux fonctions de chaîne intégrées LEN(), LEFT(), RIGHT(), SUBSTRING() et REPLACE().

Emplacement par défaut : lecteur:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\StringManipulate

Scénario

Un développeur souhaite manipuler avec précision des chaînes Unicode qui contiennent des caractères supplémentaires.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

L'exemple StringManipulate utilise les fonctionnalités suivantes de Microsoft SQL Server :

Configuration préalable requise

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

• Microsoft SQL Server 2005 ou Microsoft 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).
• 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.
• La police Ext-B doit être installée sur l'ordinateur pour que les caractères corrects apparaissent dans la fenêtre de résultats SQL Server Management Studio. Pour modifier la police de la fenêtre de résultats dans Management Studio, affichez le menu Outils, cliquez sur Options, développez Environnement, puis cliquez sur Polices et couleurs. Sélectionnez la police MingLiU_ExtB pour Résultats de texte et/ou Résultats de grille. Vous devez fermer, puis rouvrir Management Studio pour que les modifications prennent effet.

Génération de l'exemple

Si vous n'avez pas déjà créé le fichier de clé de nom fort ExternalSampleKey.snk, 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 successivement sur Tous les programmes, sur Microsoft Visual Studio 2005 et sur Outils Visual Studio, puis cliquez sur Invite de commandes de Visual Studio 2005.

   - ou -

   Ouvrez une invite de commandes de 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. À l'invite de commandes, utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif de la fenêtre d'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 Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Exemples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <system_drive>:\Program Files\Microsoft SQL Server\90\Samples.

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

   sn -k ExternalSampleKey.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 :

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\ StringManipulate.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. Si vous n'avez pas installé les exemples du moteur de base de données SQL Server à l'emplacement par défaut, modifiez le chemin d'accès dans la section CREATE ASSEMBLY du script dans Scripts\InstallCS.sql et Scripts\InstallVB.sql afin de désigner l'emplacement d'installation des exemples.

4. Ouvrez le fichier scripts\installCS.sql ou scripts\installVB.sql, selon que vous avez compilé le projet Visual C# ou Visual Basic, dans 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 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 SQL Server Management Studio. Exécutez le script contenu dans le fichier ou bien la commande suivante à partir de l'invite de commandes :

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

   Ce script appelle l'exemple de manipulation de chaîne à partir de Transact-SQL.

Suppression de l'exemple

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

Suppression de l'exemple

1. Ouvrez le fichier scripts\cleanup.sql dans SQL Server Management Studio. Exécutez le script contenu dans le fichier ou bien 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 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.

Historique des modifications