Exemple de composant ChangeCase

Article
12/15/2008

Le composant ChangeCase est un exemple de composant de transformation à sortie synchrone. Au fur et à mesure que les lignes le traversent, ce composant change la casse d'un caractère d'une chaîne en modifiant un seul caractère dans la colonne spécifiée. Pour permettre aux utilisateurs du composant de spécifier le caractère dans la colonne et le type de conversion à effectuer, deux propriétés personnalisées sont ajoutées à la colonne d'entrée de chaque colonne qui est sélectionnée pour le composant. Ces propriétés spécifient le caractère à modifier dans la colonne et précisent s'il doit être changé en majuscule ou en minuscule.

Cet exemple montre également comment implémenter une sortie d'erreur pour un composant de flux de données. Si l'utilisateur a spécifié la redirection de lignes vers la sortie d'erreur, le composant dirige une ligne vers sa sortie d'erreur lorsque l'index du caractère à modifier dépasse la longueur de la chaîne. 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.

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\ChangeCase 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

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.

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

Dans le menu Fichier, cliquez sur Ouvrir, cliquez sur Projet et ouvrez le fichier ChangeCase.sln dans le langage de programmation de votre choix.
Dans le menu Générer, cliquez sur Générer ChangeCase 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

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
Copiez l'assembly (ChangeCaseCS.dll ou ChangeCaseVB.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

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
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

Ouvrez une fenêtre d'invite de commandes.
Tapez la commande suivante pour exécuter gacutil.exe et installer la version C# du composant dans le Global Assembly Cache :

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

- or -

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

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

Pour ajouter le composant à la boîte à outils

Ouvrez Business Intelligence Development Studio.
Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir les éléments.
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.
Activez la case à cocher située en regard de votre composant, puis cliquez sur OK.

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.

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 dans la section Transformations du 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.

Test de l'exemple

Après avoir ajouté le composant à une tâche de flux de données dans un package et établi une connexion avec un composant qui lui fournira des lignes, vous pouvez le configurer de la façon suivante dans le concepteur SSIS.

Pour configurer l'exemple de composant dans un package

Cliquez sur l'onglet Colonnes d'entrée de l'éditeur avancé, et sélectionnez les colonnes que le composant doit modifier. Vous devez définir pour les colonnes sélectionnées le type d'utilisation Lecture/Écriture parce que le composant modifie les valeurs de ces colonnes lorsqu'il traite chaque ligne de données entrantes.
Cliquez sur l'onglet Propriétés des colonnes de l'éditeur avancé pour spécifier l'index de caractère de base zéro à changer dans chaque colonne d'entrée qui est modifiée et pour spécifier si le caractère à cet index est changé en majuscule (0) ou en minuscule (1).