指令碼元件的程式碼撰寫和偵錯

當您切換到程式碼設計模式時，VSTA IDE 就會開啟並顯示 ScriptMain 專案項目。ScriptMain 專案項目包含可編輯的 ScriptMain 類別，這可充當指令碼的進入點，也就是撰寫程式碼的位置。類別中的程式碼項目會根據您針對指令碼工作所選取的程式語言而變更。

指令碼專案包含兩個額外的、自動產生的唯讀專案項目：

• 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 項目以外的項目。您可以在專案中加入類別、模組、程式碼檔案和資料夾，也可以使用資料夾來整理項目群組。

所有您加入的項目都會保存在封裝內。

您可以在 [專案總管] 中以滑鼠右鍵按一下「指令碼」工作專案，再按 [加入參考]，加入 Managed 組件的參考。如需詳細資訊，請參閱＜參考指令碼解決方案中的其他組件＞。