Codifica e debug del componente script

Quando si passa alla modalità di progettazione codice, nell'IDE di VSTA viene aperto e visualizzato l'elemento del progetto ScriptMain. L'elemento del progetto ScriptMain contiene la classe ScriptMain modificabile che funge da punto di ingresso per lo script e nella quale viene scritto il codice. Gli elementi di codice nella classe variano a seconda del linguaggio di programmazione selezionato per l'attività Script.

Il progetto di script contiene due elementi del progetto aggiuntivi di sola lettura generati automaticamente:

• L'elemento del progetto ComponentWrapper contiene tre classi:

  • Classe UserComponent che eredita da ScriptComponent e contiene i metodi e le proprietà da utilizzare per elaborare i dati e interagire con il pacchetto. La classe ScriptMain eredita dalla classe UserComponent.

  • Classe della raccolta Connections che contiene riferimenti alle connessioni selezionate nella pagina Gestione connessione dell'Editor trasformazione Script.

  • Classe della raccolta Variables che contiene riferimenti alle variabili immesse nelle proprietà ReadOnlyVariable e ReadWriteVariables nella pagina Script dell'Editor trasformazione Script.

• L'elemento del progetto BufferWrapper contiene una classe che eredita da ScriptBuffer per ogni input e output configurato nella pagina Input e output dell'Editor trasformazione Script. Ognuna di queste classi contiene proprietà della funzione di accesso tipizzate corrispondenti alle colonne di input e output configurate e i buffer del flusso di dati contenenti le colonne.

Per informazioni sulla modalità di utilizzo di questi oggetti, metodi e proprietà, vedere Informazioni sul modello di oggetti del componente script. Per informazioni sulla modalità di utilizzo dei metodi e delle proprietà di queste classi in un determinato tipo di componente script, vedere la sezione Ulteriori esempi di componente script. Negli argomenti di esempio vengono inoltre presentati esempi di codice completi.

Quando si configura il componente script come trasformazione, l'elemento del progetto ScriptMain contiene il seguente codice generato automaticamente:

' Microsoft SQL Server Integration Services Script Component
' Write scripts using Microsoft Visual Basic 2008.
' ScriptMain is the entry point class of the script.

Imports System
Imports System.Data
Imports System.Math
Imports Microsoft.SqlServer.Dts.Pipeline.Wrapper
Imports Microsoft.SqlServer.Dts.Runtime.Wrapper

<Microsoft.SqlServer.Dts.Pipeline.SSISScriptComponentEntryPointAttribute> _
<CLSCompliant(False)> _
Public Class ScriptMain
    Inherits UserComponent

    Public Overrides Sub PreExecute()
        MyBase.PreExecute()
        '
        ' Add your code here for preprocessing or remove if not needed
        '
    End Sub

    Public Overrides Sub PostExecute()
        MyBase.PostExecute()
        '
        ' Add your code here for postprocessing or remove if not needed
        ' You can set read/write variables here, for example:
        ' Me.Variables.MyIntVar = 100
        '
    End Sub

    Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)
        '
        ' Add your code here
        '
    End Sub

End Class

/* Microsoft SQL Server Integration Services user script component
*  Write scripts using Microsoft Visual C# 2008.
*  ScriptMain is the entry point class of the script.*/

using System;
using System.Data;
using Microsoft.SqlServer.Dts.Pipeline.Wrapper;
using Microsoft.SqlServer.Dts.Runtime.Wrapper;

[Microsoft.SqlServer.Dts.Pipeline.SSISScriptComponentEntryPointAttribute]
public class ScriptMain : UserComponent
{

    public override void PreExecute()
    {
        base.PreExecute();
        /*
          Add your code here for preprocessing or remove if not needed
        */
    }

    public override void PostExecute()
    {
        base.PostExecute();
        /*
          Add your code here for postprocessing or remove if not needed
          You can set read/write variables here, for example:
          Variables.MyIntVar = 100
        */
    }

    public override void Input0_ProcessInputRow(Input0Buffer Row)
    {
        /*
          Add your code here
        */
    }

}

Il progetto del componente script può includere elementi diversi dall'elemento ScriptMain predefinito. È possibile aggiungere al progetto classi, moduli, file di codice e cartelle ed è possibile utilizzare le cartelle per organizzare gruppi di elementi.

Tutti gli elementi aggiunti vengono salvati in modo permanente nel pacchetto.

È possibile aggiungere riferimenti agli assembly gestiti facendo clic con il pulsante destro del mouse sul progetto di attività Script in Esplora progetti, quindi scegliendo Aggiungi riferimento. Per ulteriori informazioni, vedere Riferimenti ad altri assembly nelle soluzioni di scripting.