Exemple de composant DataSetDestination

L'exemple DataSetDestination montre comment implémenter un composant de destination personnalisée qui est intégré à Business Intelligence Development Studio et peut être ajouté à une tâche de flux de données. Ce composant stocke les lignes qu'il reçoit durant l'exécution dans un dataset. À la fin de l'exécution, selon la configuration du composant, le dataset est affecté à une variable d'exécution et peut aussi être enregistré dans un fichier XML. Le fichier XML créé à partir du dataset peut être utilisé en tant que source XML de la source XML. Cette structure permet d'enregistrer de façon externe les résultats d'une exécution du flux de données et de les utiliser comme source d'un autre composant. Cet exemple n'est pas pris en charge sur des systèmes d'exploitation Itanium.

Important :

Les exemples de code de programmation de flux de données Integration Services ont pour but de montrer les fonctionnalités principales à implémenter pour créer un composant de flux de données personnalisé. Les exemples ne comportent pas de prise en charge complète de la personnalisation dans l'éditeur avancé. Par exemple, vous ne pouvez pas utiliser l'éditeur avancé pour ajouter ou supprimer des entrées et des sorties ou pour configurer des colonnes. Les exemples sont fournis uniquement à titre éducatif. 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\Data Flow\ DataSetDestination Component Sample\

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

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 pour signer les assemblys au moment de la génération avec ce fichier de clé. Vous pouvez consulter les propriétés de signature dans l'onglet Signature de la boîte de dialogue Propriétés du projet.

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

1. 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 du 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.

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

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

   sn -k SampleKey.snk
   

4. 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 le .NET Framework, dans le Centre de développement .NET sur MSDN.

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

1. Dans le menu Fichier, cliquez sur Ouvrir, cliquez sur Projet et ouvrez le fichier DataSetDestination.sln dans le langage de programmation de votre choix.

2. Dans le menu Générer, cliquez sur Générer DataSetDestination pour générer le projet.

Installation de l'exemple

Cet exemple est fourni en Visual Basic et en C#. Pour distinguer les assemblys de chaque version de l'exemple, CS ou VB 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 à une tâche de flux de données dans Business Intelligence Development Studio.

Pour copier le composant dans le dossier PipelineComponents

1. Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.

2. Copiez l'assembly (DataSetDestinationCS.dll ou DataSetDestinationVB.dll) dans le dossier PipelineComponents situé dans %system%\Program Files\Microsoft SQL Server\90\DTS.

Pour installer le composant dans le GAC (Global Assembly Cache) en faisant glisser l'assembly

1. Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.

2. Faites glisser l'assembly du dossier PipelineComponents 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

1. Ouvrez une fenêtre d'invite de commandes.

2. Tapez la commande suivante pour exécuter gacutil.exe et installer la version C# du composant dans le GAC :

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationCS.dll "

   - or -

   Tapez la commande suivante pour exécuter gacutil.exe et installer la version Visual Basic du composant dans le GAC :****

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationVB.dll "

Pour ajouter le composant à la boîte à outils

1. Ouvrez Business Intelligence Development Studio.

2. Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir les éléments.

3. Dans la boîte de dialogue Choisir des éléments de boîte à outils, cliquez sur l'onglet Éléments de flux de données SSIS.

4. Activez la case à cocher située en regard de votre composant, puis cliquez sur OK.

5. Remarque   Si le composant ne figure pas dans la liste, cliquez sur Parcourir pour le rechercher. Dans ce cas, toutefois, il risque de ne pas s'installer correctement.

Une fois ces étapes effectuées, le composant est visible sous l'onglet Éléments de flux de données de la Boîte à outils, et vous pouvez l'ajouter à la tâche de flux de données dans le Concepteur SSIS.

Test de l'exemple

Après avoir ajouté l'exemple de composant à une tâche de flux de données dans un package, vous pouvez le configurer dans le concepteur SSIS. Le composant DataSetDestination possède trois propriétés personnalisées qui contrôlent son comportement à l'exécution. L'exécution du composant réussit si vous conservez les valeurs par défaut de ces propriétés. Dans ce cas, le dataset n'est pas enregistré à la fin de l'exécution.