Exemple de paramètre tableau
Mis à jour : 14 avril 2006
Il est parfois utile de créer, de mettre à jour ou de supprimer un ensemble de lignes dans une base de données. Il existe plusieurs méthodes que vous pouvez utiliser dans ce but. L'une d'elles consiste à transmettre un tableau d'informations d'un client à une procédure stockée d'intégration CLR (Common Language Runtime) sur le serveur en utilisant un type de données d'intégration du CLR défini par l'utilisateur. La nature de tels types de données définis par l'utilisateur limite à 8000 octets le volume des données fournies au serveur. De ce fait, cette méthode n'est pas satisfaisante pour les données volumineuses ou complexes. Pour plus d'informations, consultez la procédure stockée de création de contact dans l'exemple Couche CLR de la base de données Adventure Works Cycles. Si les données manipulées sont simples et de petite taille, cette méthode peut s'avérer beaucoup plus efficace que l'appel d'une procédure stockée pour chaque ligne. En utilisant un tableau, l'ordre des données est préservé pour les applications où l'ordre a de l'importance.
Cet exemple contient les éléments suivants :
- Le type de données défini par l'utilisateur
ContactTypeNames. Ce type de données renferme une liste des noms de type de contact souhaité. - La procédure stockée
usp_EnsureContactTypeNamesmise en œuvre en tant que méthode Microsoft Visual C# ou Microsoft Visual Basic. Une instance du type de données défini par l'utilisateurContactTypeNamesest ainsi acceptée et de nouvelles lignes dans la table Person.ContactType sont insérées pour tous les noms de contact contenus dans l'instance du type de données défini par l'utilisateur et qui ne se trouvent pas encore dans cette table. - L'application console
TestArrayParameter. Une instance du type de données défini par l'utilisateurContactTypeNamesest ainsi créée en fonction des paramètres de ligne de commande qui lui sont transmis, puis la procédure stockéeusp_EnsureContactTypeNamesest appelée en passant l'instance du type de données défini par l'utilisateur comme paramètre.
Répertoire d'installation : lecteur:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\ArrayParameter\
Scénario
Jean est développeur chez Adventure Works Cycles. Il doit insérer quelques lignes simples dans une table mais souhaite minimiser le nombre de parcours complets de la base de données.
Langages
Transact-SQL, Visual C# et Visual Basic.
Fonctionnalités
L'exemple de paramètre tableau utilise les fonctionnalités suivantes de Microsoft .
| Domaine d'application | Fonctionnalités |
|---|---|
Général |
CLR, type de données défini par l'utilisateur, Transact-SQL |
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 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.
.gif "ms160951.note(fr-fr,SQL.90).gif")
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. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :
sn -k SampleKey.snkImportant :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 de paramètre tableau
Compilez l'exemple au moyen de Visual Studio 2005 et de la solution Visual Studio fournie, ou à l'aide de Microsoft MSBuild présent dans le Kit de développement logiciel .NET Framework SDK 2.0. À l'invite de commandes .NET Framework, exécutez des commandes semblable à celle-ci :
msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ArrayParameter.slnVé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 partie CREATE ASSEMBLY du script qui se trouve dans Scripts\InstallCS.sql de façon à 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 Visual Basic, dans SQL Server Management Studio. Exécutez le script contenu dans le fichier ou entrez une commande présentant l'aspect suivant dans une fenêtre d'invite de commandes :
sqlcmd -E -I -i Scripts\InstallCS.sql
Exécution de l'exemple
Pour exécuter l'exemple de paramètre tableau
À une invite de commandes, utilisez la commande cd (Change Directory) pour remplacer le dossier actif de la fenêtre d'invite de commandes par le le répertoire de l'exemple ArrayParameter. À l'invite de commandes, exécutez la commande suivante :
Scripts\TestCS.cmd
Suppression de l'exemple
Pour supprimer l'exemple de paramètre tableau
Ouvrez le fichier scripts\cleanup.sql dans Management Studio. Exécutez le script contenu dans le fichier ou, dans une fenêtre d'invite de commandes, la commande suivante :
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
Tâches
Couche CLR de la base de données Adventure Works Cycles
Aide et Informations
Assistance sur SQL Server 2005
Historique des modifications
| Version | Historique |
|---|---|
5 décembre 2005 |
|