脚本组件的编码和调试

切换到代码设计模式后，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 项以外的其他项。您可以向项目中添加类、模块、代码文件和文件夹，并使用文件夹来组织项组。

您添加的所有项在包中都将持久化。

在**“项目资源管理器”中右键单击脚本任务项目，然后单击“添加引用”**，可以添加对托管程序集的引用。有关详细信息，请参阅引用脚本解决方案中的其他程序集。

注意
您可以在 VSTA IDE 中的“类视图”或“项目资源管理器”中查看项目引用。这些窗口都可以从“视图”菜单中打开。您可以从“项目”菜单、“项目资源管理器”或“类视图”添加新引用。