Exemple Excel2 Custom Connection Manager

Article
12/15/2008

Nouveau : 14 avril 2006

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

Pour plus d'informations sur la création d'un module fournisseur d'informations 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 à un classeur Microsoft Excel disponible à l'aide du fournisseur de données .NET Framework OleDb et du fournisseur Microsoft OLE DB pour Jet, et retourne un objet OleDbConnection ouvert à partir de sa méthode AcquireConnection. Lorsque vous créez une nouvelle instance du gestionnaire de connexions Excel2 dans un package, son interface utilisateur personnalisée vous demande d'indiquer le chemin d'accès au classeur Excel. Ce gestionnaire de connexions présente également une case à cocher permettant de préciser le mode d'importation. Ceci résout un problème qui se produit fréquemment dans le cadre de colonnes Excel contenant du texte mixte et des données numériques.

Remarque :
L'exemple Excel2 Custom Connection Manager ne peut pas être utilisé avec la source et la destination Excel. Testez-le avec la source et la destination DataReader.

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 cet exemple.

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\Excel2ConnectionManager Sample

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

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, puis ouvrez le fichier Excel2ConnMgrVB.sln ou Excel2ConnMgrCS.sln.
Dans l'Explorateur de solutions, sélectionnez le projet Excel2ConnMgrVB ou Excel2ConnMgrCS.
Recherchez l'attribut DtsConnection avant la déclaration de classe dans le fichier Excel2ConnMgrCS.cs ou le fichier Excel2ConnMgrVB.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 pour 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 (Excel2ConnMgrCS.dll et Excel2ConnMgrUICS.dll, ou Excel2ConnMgrVB.dll et Excel2ConnMgrUIVB.dll) dans le dossier Connections situé dans %system%\Program Files\Microsoft SQL Server\90\DTS\Connections.

Pour installer le composant dans le Global Assembly Cache (GAC) en effectuant un glisser-déplacer des 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\Excel2ConnectionManager Sample\CS\Excel2ConnMgrCS\bin\Debug\Excel2ConnMgrCS.dll"
gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrUICS\bin\Debug\Excel2ConnMgrUICS.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\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrUIVB.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 EXCEL2 dans la liste des types de connexions disponibles. Cliquez sur OK.

Modifiez le nouveau gestionnaire de connexions. Dans la boîte de dialogue Éditeur du gestionnaire de connexions Excel2, recherchez un classeur Excel disponible. À l'aide des cases à cocher, spécifiez les paramètres des en-têtes et ceux du mode d'importation.

Remarque :
L'exemple du gestionnaire de connexions personnalisé Excel2 ne peut être utilisé avec la source qui prend uniquement en charge le gestionnaire de connexions Excel intégré. Testez-le avec la source DataReader à la place.