Exemple HtmlLogProvider

Nouveau : 14 avril 2006

L'exemple HtmlLogProvider montre comment créer un module fournisseur d'informations personnalisé, le module fournisseur d'informations HTML, qui enregistre la sortie d'enregistrement dans un document HTML.

Pour plus d'informations sur la manière de créer un module fournisseur d'informations personnalisé, consultez Creating a Custom Log Provider. Pour obtenir des informations générales sur l'utilisation des modules fournisseurs d'informations dans Integration Services, consultez Modules fournisseurs d'informations d'Integration Services.

Le module fournisseur d'informations personnalisé obtient le nom d'un fichier de destination doté de l'extension .htm ou .html à partir d'un gestionnaire de connexions de fichiers existant. Il émet en sortie des événements enregistrés dans un tableau HTML dans le fichier de destination spécifié, en ignorant les deux colonnes standard finales (dataCode et dataBytes) qui peuvent contenir des données binaires susceptibles de ne pas s'afficher correctement dans un document HTML. Dans cet exemple, le code d'enregistrement HTML est encapsulé dans une classe d'assistance HtmlLogWriter distincte pour pouvoir être réutilisé aisément. Cette classe d'assistance possède des sous-routines OpenLogHtml, LogHtml et CloseLogHtml, qui sont appelées à partir de OpenLog, Log et CloseLog respectivement. Cet exemple n'est pas pris en charge sur des systèmes d'exploitation Itanium.

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

• Remplacement de la classe LogProviderBase.
• Prise en charge de la persistance par défaut qui ne requiert pas l'écriture d'un code de persistance personnalisé par le développeur.

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\HtmlLogProvider 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 dans l'onglet Signature de la boîte de dialogue Propriétés du projet pour signer, au moment de la génération, les assemblys à l'aide de ce fichier de clé.

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 l'invite de commandes de Microsoft .NET Framework, cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK v2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

2. À l'invite de commandes, utilisez la commande cd (Change Directory) pour ouvrir le dossier Samples dans l'invite de commandes. 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
   

   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

1. Dans le menu Fichier | Ouvrir, cliquez sur Projet et ouvrez HtmlLogProviderVB.sln ou HtmlLogProviderCS.sln.

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

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

2. Copiez l'assembly (HtmlLogProviderCS.dll ou HtmlLogProviderVB.dll) dans le dossier LogProviders qui se trouve dans %system%\Program Files\Microsoft SQL Server\90\DTS.

Pour installer le composant dans le Global Assembly Cache (GAC) en effectuant un glisser-déplacer des assemblys

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 LogProviders vers le dossier dans lequel se trouve le Global Assembly Cache (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 les commandes suivantes pour installer la version C# du composant dans le Global Assembly Cache :

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

   - ou -

   Tapez les commandes suivantes pour installer la version Visual Basic du composant dans le Global Assembly Cache :

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

Test de l'exemple

Vous pouvez désormais tester le module fournisseur d'informations personnalisé dans un package.

Pour utiliser le module fournisseur d'informations personnalisé dans un package

1. Dans un projet Integration Services, ajoutez un nouveau gestionnaire de connexions de fichiers et configurez-le pour qu'il pointe sur un fichier doté de l'extension **.**htm ou **.**html.

2. Dans le menu SSIS, sélectionnez Enregistrement et ajoutez le module fournisseur d'informations personnalisé pour les fichiers HTML (CS) ou le module fournisseur d'informations personnalisé pour les fichiers HTML (VB).

3. Dans la colonne Configuration, entrez le nom du gestionnaire de connexions de fichiers.

4. Configurez l'enregistrement de manière appropriée, de sorte que le package et ses composants enregistrent leurs événements dans le module fournisseur d'informations personnalisé.

5. Exécutez le package, puis ouvrez le fichier HTML pour afficher la sortie d'enregistrement.