Exemple Sql Server Custom Connection Manager

Article
12/15/2008

Mis à jour : 14 avril 2006

L'exemple SQL Server Custom Connection Manager montre comment créer un gestionnaire de connexions personnalisé et son interface utilisateur associée. Cet exemple n'est pas pris en charge sur des systèmes d'exploitation Itanium.

Pour plus informations sur la création d'un gestionnaire de connexions personnalisé, consultez Creating a Custom Connection Manager. Pour obtenir des informations d'ordre général sur l'utilisation des gestionnaires de connexions dans Integration Services, consultez Connexions d'Integration Services et Gestionnaires de connexions.

Le gestionnaire de connexions personnalisé se connecte à une instance disponible de Microsoft SQL Server à l'aide du fournisseur de données .NET Framework SqlClient et retourne un objet SqlConnection ouvert à partir de sa méthode AcquireConnection. Lorsque vous créez une nouvelle instance de Sql Connection Manager dans un package, son interface utilisateur personnalisée vous invite à indiquer le nom du serveur et un nom de base de données. L'exemple se connecte uniquement à une instance de SQL Server par défaut et n'utilise que l'authentification Windows.

Cet exemple de code implémente les fonctionnalités suivantes :

Remplacement de la classe ConnectionManagerBase.
Prise en charge de la persistance.

Important :
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.

Exécution de l'exemple

Si vous savez déjà commencer localiser, générer et installer les exemples de code, vous pouvez vous rendre directement à la section Test de l'exemple pour savoir comment configurer et exécuter l'exemple de code.

Configuration requise

Cet exemple nécessite l'installation des composants suivants.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Emplacement

Si l'exemple de code a été installé à l'emplacement par défaut, l'exemple se trouve dans le répertoire suivant :

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

La solution C# pour l'exemple de code se trouve dans le répertoire SqlConnMgrCS et la solution Visual Basic dans le répertoire SqlConnMgrVB.

Pour obtenir des informations sur la procédure à deux étapes que vous devez suivre pour installer les exemples, consultez Installation des exemples. Pour vous procurer la dernière version des exemples, y compris les nouveaux exemples publiés après la version d'origine de SQL Server 2005, consultez Exemples et exemples de base de données SQL Server 2005 (avril 2006).

Génération de l'exemple

Si vous n'avez pas encore généré de fichier de clé de nom fort dans le dossier Samples, procédez de la façon suivante pour le générer. Les exemples de projets sont configurés dans l'onglet Signature de la boîte de dialogue Propriétés du projet pour signer les assemblys au moment de la génération avec ce fichier de clé.

Pour générer un fichier de clé de nom fort

Pour ouvrir une invite de commandes de 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 -

Pour ouvrir une invite de commandes de Microsoft .NET Framework, cliquez sur Démarrer, pointez sur Tous les programmes et sur Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

À 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 Samples. Le fichier de clé que vous créez dans ce dossier sera utilisé par tous les exemples de code SQL Server 2005.

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 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\90\Samples.

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\90\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.

Vous aurez besoin du jeton de clé publique provenant du fichier de clé dans une étape ultérieure. Pour obtenir le jeton de clé publique, vous devez d'abord extraire la clé publique du fichier de clé et la placer dans un nouveau fichier en exécutant la commande suivante à l'invite de commandes :
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
Ensuite, affichez le jeton de clé publique à partir du nouveau fichier en exécutant la commande suivante à l'invite de commandes :
```
sn -t SampleKeyPublic.snk
```
Copiez le jeton de clé publique dans le Presse-papiers ou enregistrez-le pour l'utiliser ultérieurement.

Pour générer l'exemple dans Microsoft Visual Studio 2005

Dans le menu Fichier | Ouvrir, cliquez sur Projet et ouvrez le fichier solution SqlConnMgrVB.sln ou SqlConnMgrCS.sln.
Dans l'Explorateur de solutions, sélectionnez le projet SqlConnMgrVB ou SqlConnMgrCS.
Recherchez l'attribut DtsConnection avant la déclaration de classe dans le fichier SqlConnMgrCS.cs ou le fichier SqlConnMgrVB.vb, puis remplacez la valeur alphanumérique de jeton de clé publique dans la propriété UITypeName de l'attribut par le jeton de clé publique obtenu précédemment dans le fichier de clé.
Dans le menu Générer, cliquez sur Générer la solution.

Installation de l'exemple

Cet exemple est fourni en Visual Basic et en C#. Pour effectuer la distinction entre les assemblys de chaque version de l'exemple, CS ou BV est ajouté à la fin du nom de l'assembly de sortie. Après avoir généré le composant, effectuez les étapes suivantes pour l'ajouter en tant que gestionnaire de connexions dans un package dans Business Intelligence Development Studio.

Pour copier le composant dans le dossier Connections

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
Copiez les assemblys (SqlConnMgrCS.dll et SqlConnMgrUICS.dll, ou SqlConnMgrVB.dll et SqlConnMgrUIVB.dll) dans le dossier Connections situé dans %system%\Program Files\Microsoft SQL Server\90\DTS.

Pour installer le composant dans le GAC (Global Assembly Cache) en faisant glisser-déplacer les assemblys

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
Faites glisser les assemblys depuis le dossier Connections vers le dossier dans lequel se trouve le GAC dans %system%\assembly.

Pour installer le composant dans le Global Assembly Cache (GAC) à l'aide de gacutil.exe

Ouvrez une fenêtre d'invite de commandes.

Tapez les commandes suivantes pour installer la version C# du composant et l'interface utilisateur dans le Global Assembly Cache :

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

- ou -

Tapez les commandes suivantes pour installer la version Visual Basic du composant et l'interface utilisateur dans le Global Assembly Cache :

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

Test de l'exemple

Vous pouvez désormais tester le gestionnaire de connexions personnalisé dans un package.

Pour utiliser l'exemple de gestionnaire de connexions dans un package

Dans la zone des gestionnaires de connexions du concepteur SSIS, cliquez avec le bouton droit, sélectionnez Nouvelle connexion, puis sélectionnez SQL dans la liste des types de connexions disponibles. Cliquez sur OK.
Modifiez le nouveau gestionnaire de connexions. Dans l'Éditeur du gestionnaire de connexions Sql, indiquez le nom d'une instance disponible du moteur de base de données SQL Server.

Historique des modifications

Version	Historique
14 avril 2006	Contenu modifié : Correction des noms de fichiers et de dossiers.

Partager via