Exemple HelloWorldReady

Article
12/15/2008

Mis à jour : 5 décembre 2005

L'exemple HelloWorldReady présente les opérations de base à effectuer pour créer, déployer et tester une procédure stockée simple basée sur l'intégration du CLR (Common Language Runtime) et adaptée pour un usage international. Un composant est dit adapté pour un usage international lorsqu'il est possible de le localiser facilement, sans changer son code source, en différentes langues pour divers marchés dans le monde entier. Cet exemple montre également comment retourner des données via un paramètre de sortie et via un enregistrement qui est construit dynamiquement par la procédure stockée et retourné au client.

Cet exemple est presque identique à l'exemple Hello World, mais l'application qu'il propose est beaucoup plus facile et plus sûre à localiser. La modification du texte localisé nécessite les opérations suivantes :

Modification d'un fichier XML (fichier .resx) pour intégrer la culture particulière dans le répertoire des ressources.
Génération du fichier des ressources de la culture à l'aide de l'utilitaire resgen.
Génération de la DLL satellite mise à jour pour cette culture.
Suppression et ajout de cet assembly dans SQL Server.

Le code source et l'assembly pour la procédure stockée CLR elle-même ne changent pas. Un script build.cmd est fourni dans le répertoire des ressources pour montrer comment compiler et lier les assemblys de ressources.

Bien que le code source de l'application crée un gestionnaire de ressources fondé sur l'assembly en cours d'exécution, vous n'avez pas besoin d'incorporer les ressources indépendantes de la culture dans la DLL qui contient la procédure stockée. L'attribut System.Resources.NeutralResourcesLanguage utilisé dans le fichier AssemblyInfo.cs ou AssemblyInfo.vb permet aux ressources indépendantes de la culture d'exister dans une DLL satellite. Il est bien plus avantageux d'utiliser une DLL distincte à cet effet, de sorte qu'il ne soit pas nécessaire de modifier la DLL principale contenant la procédure stockée CLR lorsqu'un texte localisé doit être ajouté ou modifié. Ceci s'avère particulièrement utile pour les types CLR définis par l'utilisateur qui peuvent avoir des colonnes et d'autres dépendances qui rendraient difficiles leur suppression et leur rajout.

En général, les versions de la DLL satellite doivent être identiques à la version de l'assembly principal. Toutefois, vous pouvez utiliser l'attribut SatelliteContractVersion pour permettre une mise à jour de l'assembly principal sans mise à jour des assemblys satellites. Pour plus d'informations, consultez la classe ResourceManager dans la documentation du Kit de développement (SDK) de Microsoft .NET Framework version 2.0.

Répertoire d'installation : lecteur:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\HelloWorldReady\

Scénario

Jean est développeur chez Adventure Works Cycles. Il souhaite apprendre à utiliser les procédures stockées d'intégration du CLR. Il souhaite également comprendre comment adapter ses procédures stockées d'intégration du CLR pour une utilisation internationale en utilisant des ressources, conformément à la technique d'implémentation utilisée par son équipe de développement.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

L'exemple HelloWorldReady utilise les fonctionnalités suivantes de SQL Server.

Domaine d'application	Fonctionnalités
Général	CLR, métadonnées
Localisation	Ressources

Configuration requise

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

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).
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

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

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.

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.

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.

À 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 HelloWorldReady

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 d'une invite de commandes SDK, exécutez une commande semblable à celle-ci :

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ HelloWorld.sln
Compilez les assemblys satellites en exécutant à l'invite de commandes du .NET Framework ou de Visual Studio le fichier build.cmd fourni dans le répertoire des ressources. Ce fichier appelle resgen, qui est inclus dans Visual Studio ou dans le Kit de développement (SDK) .NET Framework.
Vérifiez que la base de données AdventureWorks est installée.
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 (fichiers Scripts\InstallCS.sql et Scripts\InstallVB.sql) afin de désigner l'emplacement où vous avez installé ces exemples.
Si vous n'êtes pas un administrateur de l'instance de SQL Server que vous utilisez, demandez à un administrateur de vous accorder l'autorisation CreateAssembly pour effectuer l'installation.
Ouvrez le fichier scripts\installCS.sql ou scripts\installVB.sql, selon que vous avez compilé le projet Visual C# ou le projet Visual Basic, dans Microsoft 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

Exécution de l'exemple

Pour exécuter l'exemple HelloWorldReady

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

Suppression de l'exemple

Pour supprimer l'exemple HelloWorldReady

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

Commentaires

Pour que cet exemple fonctionne correctement, vous devez activer le Common Language Runtime pour SQL Server 2005 ou SQL Server Express.

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

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.

Partager via