スクリプト コンポーネントのコーディングおよびデバッグ

コード デザイン モードに切り替えると、VSTA IDE が開き、ScriptMain プロジェクト アイテムが表示されます。ScriptMain プロジェクト アイテムには、編集可能な ScriptMain クラスが含まれています。このクラスは、スクリプトのエントリ ポイントとしての役割を果たし、ここにコードを記述します。このクラスのコード要素は、スクリプト タスクに対して選択したプログラミング言語に応じて異なります。

スクリプト プロジェクトには、次の 2 つの読み取り専用のプロジェクト アイテムが自動生成され、追加されます。

• 次の 3 つのクラスを含む ComponentWrapper プロジェクト アイテム。

  • UserComponent クラス。ScriptComponent から継承され、データの処理およびパッケージとのやり取りに使用するメソッドおよびプロパティが含まれています。ScriptMain クラスは UserComponent クラスから継承されます。

  • Connections コレクション クラス。[スクリプト変換エディター] の [接続マネージャー] ページで選択された、接続への参照が含まれています。

  • Variables コレクション クラス。[スクリプト変換エディター] の [スクリプト] ページで、ReadOnlyVariable および ReadWriteVariables プロパティに入力された変数への参照が含まれています。

• BufferWrapper プロジェクト アイテム。[スクリプト変換エディター] の [入力および出力] ページで構成された各入力および出力に対して、ScriptBuffer から継承されたクラスが含まれています。これらの各クラスには、構成された入力列と出力列、およびそれらの列が含まれるデータ フロー バッファーに対応する、型指定されたアクセサー プロパティが含まれています。

これらのオブジェクト、メソッド、およびプロパティの使用方法については、「スクリプト コンポーネントのオブジェクト モデルについて」を参照してください。特定の種類のスクリプト コンポーネントで、これらのクラスのメソッドおよびプロパティを使用する方法については、セクション「その他のスクリプト コンポーネントの例」を参照してください。サンプルについてのトピックでは、完全なコード例も示します。

スクリプト コンポーネントを変換として構成すると、ScriptMain プロジェクト アイテムに次のコードが自動生成されます。

' 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
        */
    }

}

スクリプト コンポーネント プロジェクトには、既定の ScriptMain アイテム以外のアイテムを格納できます。プロジェクトには、クラス、モジュール、コード ファイル、およびフォルダーを追加できます。また、フォルダーを使用してアイテムのグループを整理できます。

追加したすべてのアイテムは、パッケージ内部に保存されます。

参照をマネージ アセンブリに追加するには、[プロジェクト エクスプローラー] でスクリプト タスク プロジェクトを右クリックし、[参照の追加] をクリックします。詳細については、「スクリプティング ソリューションでの他のアセンブリの参照」を参照してください。

注
プロジェクト参照は、VSTA IDE の [クラス ビュー] または [プロジェクト エクスプローラー] で表示できます。どちらのウィンドウも [表示] メニューから開きます。新しい参照は、[プロジェクト] メニュー、[プロジェクト エクスプローラー]、または [クラス ビュー] から追加できます。