Condividi tramite

Esempio HtmlLogProvider

  • Articolo

Data creazione: 14 aprile 2006

Nell'esempio HtmlLogProvider viene illustrato come creare un provider di log personalizzato, Html Log Provider, che scrive l'output di registrazione in un documento HTML.

Per ulteriori informazioni sulla creazione di un provider di log personalizzato, vedere Creating a Custom Log Provider. Per informazioni generali sull'utilizzo dei provider di log in Integration Services, vedere Provider di log di Integration Services.

Il provider di log personalizzato ottiene il nome di un file di destinazione con estensione htm o html da una gestione connessione file esistente. Gli eventi registrati vengono scritti in una tabella HTML nel file di destinazione specificato, ignorando le due colonne standard finali (dataCode e dataBytes) le quali potrebbero contenere dati binari che non possono essere visualizzati correttamente in un documento HTML. L'esempio incapsula il codice di registrazione HTML in una classe helper HtmlLogWriter separata per consentirne un facile riutilizzo. La classe helper contiene le subroutine OpenLogHtml, LogHtml e CloseLogHtml chiamate rispettivamente da OpenLog, Log e CloseLog. Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.

Con questo esempio di codice vengono implementate le funzionalità seguenti:

  • Overriding della classe LogProviderBase.
  • Supporto predefinito della persistenza, che non richiede la scrittura di codice di persistenza personalizzato da parte dello sviluppatore.
ms365184.note(it-it,SQL.90).gifImportante:
Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi.

Esecuzione dell'esempio

Se non sono necessarie informazioni sulle procedure per l'individuazione, la generazione e l'installazione degli esempi di codice, è possibile passare direttamente alla sezione Test dell'esempio per informazioni sulla configurazione e l'esecuzione dell'esempio di codice.

Prerequisiti

Per l'esecuzione di questo esempio è necessario che siano installati i componenti seguenti.

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

Percorso

Se l'esempio di codice è stato installato nel percorso predefinito, l'esempio si trova nella directory seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\HtmlLogProvider Sample

La versione C# dell'esempio di codice si trova nella directory CS, mentre la versione Visual Basic si trova nella directory VB.

Per ulteriori informazioni sul processo in due fasi necessario per l'installazione degli esempi, vedere Installazione degli esempi. Per ottenere la versione più recente degli esempi, inclusi nuovi esempi resi disponibili dopo il rilascio di SQL Server 2005, vedere Esempi e database di esempio di SQL Server 2005 (aprile 2006).

Generazione dell'esempio

Se non è stato ancora generato un file di chiave con nome sicuro nella cartella Samples, eseguire la procedura seguente per generarlo. Nella scheda Firma della finestra di dialogo Proprietà progetto sono configurati progetti di esempio per la firma di assembly durante la generazione con questo file di chiave.

Per generare un file di chiave con nome sicuro

  1. Per aprire il prompt dei comandi di Microsoft Visual Studio 2005, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2005, Visual Studio Tools e quindi fare clic su Prompt dei comandi di Visual Studio 2005.

    -oppure-

    Per aprire il prompt dei comandi di Microsoft .NET Framework, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK v2.0 e quindi SDK Command Prompt.

  2. Al prompt dei comandi passare dalla directory corrente alla cartella Samples mediante il comando CD (Change Directory). Il file di chiave creato in questa cartella verrà utilizzato da tutti gli esempi di codice di SQL Server 2005.

    [!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni e quindi Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <system_drive>:\Programmi\Microsoft SQL Server\90\Samples.

  3. Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

    sn -k SampleKey.snk
    ms365184.note(it-it,SQL.90).gifImportante:
    Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN (informazioni in lingua inglese).

Per generare l'esempio in Microsoft Visual Studio 2005

  1. Scegliere Apri dal menu File, fare clic su Progetto e aprire HtmlLogProviderVB.sln o HtmlLogProviderCS.sln.

  2. Scegliere Genera soluzione dal menu Genera per generare la soluzione.

Installazione dell'esempio

Questo esempio è disponibile in Visual Basic e C#. Per distinguere gli assembly delle due versioni dell'esempio, al nome degli assembly di output sono stati aggiunti i suffissi CS e VB. Dopo aver generato il componente, eseguire la procedura seguente per aggiungerlo come gestione connessione in un pacchetto di Business Intelligence Development Studio.

Per copiare il componente nella cartella Connections

  1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

  2. Copiare l'assembly (HtmlLogProviderCS.dll o HtmlLogProviderVB.dll) nella cartella LogProviders in %system%\Programmi\Microsoft SQL Server\90\DTS.

Per installare il componente nella cache di assembly globale (CAG) trascinando gli assembly

  1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

  2. Trascinare l'assembly dalla cartella LogProviders nella cartella in cui si trova la cache di assembly globale (CAG), nel percorso %system%\assembly.

Per installare il componente nella cache di assembly globale (CAG) tramite gacutil.exe

  1. Aprire la finestra del prompt dei comandi.

  2. Digitare i comandi seguenti per installare la versione C# del componente nella cache di assembly globale (CAG):

    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"

    -oppure-

    Digitare i comandi seguenti per installare la versione Visual Basic del componente nella cache di assembly globale (CAG):

    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 dell'esempio

È ora possibile testare il provider di log personalizzato in un pacchetto.

Per utilizzare il provider di log di esempio in un pacchetto

  1. In un progetto di Integration Services aggiungere una gestione connessione file e configurarla affinché faccia riferimento a un file con estensione htm o html.

  2. Scegliere Registrazione dal menu SSIS e aggiungere i file del provider di log personalizzato per HTML relativi alla versione CS o VB.

  3. Nella colonna Configurazione, specificare il nome della gestione connessione file.

  4. Configurare la registrazione in modo appropriato affinché gli eventi del pacchetto e dei relativi componenti vengano registrati nel provider di log personalizzato.

  5. Eseguire il pacchetto e quindi aprire il file HTML per visualizzare l'output della registrazione.