在脚本组件编辑器中配置脚本组件

对于转换组件和目标组件，将显示**“脚本转换编辑器”的“输入列”**页；对于源组件则不显示该页。在此页中，可以选择希望用于自定义脚本的可用输入列，然后指定可对这些列进行只读还是读/写访问。

在将要基于此元数据生成的代码项目中，BufferWrapper 项目项包含每个输入的一个类，并且此类包含每个所选输入列的类型化取值函数属性。例如，如果从名为 CustomerInput 的输入中选择一个整型 CustomerID 列和一个字符串型 CustomerName 列，则 BufferWrapper 项目项将包含从 ScriptBuffer 派生的 CustomerInput 类，并且 CustomerInput 类将公开名为 CustomerID 的整型属性和名为 CustomerName 的字符串型属性。使用此约定可编写能够进行类型检查的代码，如下所示：

Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName

有关如何为特定类型的数据流组件配置输入列的详细信息，请参阅开发特定类型的脚本组件下的相应示例。

**“脚本转换编辑器”的“输入和输出”**页会为源、转换和目标显示。在此页中，可以添加、删除和配置要在自定义脚本中使用的输入、输出和输出列，但存在以下限制：

• 用作源时，脚本组件没有输入，支持多个输出。

• 用作转换时，脚本组件支持一个输入和多个输出。

• 用作目标时，脚本组件支持一个输入，没有输出。

在将要基于此元数据生成的代码项目中，BufferWrapper 项目项包含每个输入和输出的一个类。例如，如果创建一个名为 CustomerOutput 的输出，则 BufferWrapper 项目项将包含一个从 ScriptBuffer 派生的 CustomerOutput 类，并且 CustomerOutput 类将包含每个所创建的输出列的类型化取值函数属性。

您只能在**“输入和输出”页中配置输出列。可在“输入列”页中选择转换和目标的输入列。在 BufferWrapper 项目项中创建的类型化取值函数属性对于输出列来说是只写的。输入列的取值函数属性将为只读还是读/写取决于在“输入列”**页中为每列所选的使用类型。

有关为特定类型的数据流组件配置输入和输出的详细信息，请参阅开发特定类型的脚本组件下的相应示例。

注意
虽然您无法在脚本组件中直接将输出配置为错误输出以便自动处理错误行，但必要时可通过创建附加输出并使用脚本将行定向到此输出来再现错误输出的功能。有关详细信息，请参阅模拟脚本组件的错误输出。

输出的 ExclusionGroup 和 SynchronousInputID 属性

ExclusionGroup 属性仅在具有同步输出的转换中具有非零值，其中您的代码要执行筛选或分支跳转，并将每一行定向到共享同一非零 ExclusionGroup 值的输出之一。例如，转换可将行定向到默认输出或错误输出。在此方案中，如果您创建附加输出，请确保将 SynchronousInputID 属性的值设置为与组件的输入 ID 相匹配的整数。

SynchronousInputID 属性仅在具有同步输出的转换中具有非零值。如果此属性的值为零，则意味着输出是异步的。对于同步输出，行将传递给所选一个或多个输出而不添加任何新行，此属性应包含组件的输入 ID。

注意
“脚本转换编辑器”创建第一个输出时，该编辑器会将输出的 SynchronousInputID 属性设置为组件的输入 ID。但是，当编辑器创建后续输出时，它会将那些输出的 SynchronousInputID 属性设置为零。 如果您创建的是具有同步输出的组件，则每个输出的 SynchronousInputID 属性必须设置为组件的输入 ID。因此，编辑器在第一个输出之后创建的每个输出的 SynchronousInputID 值必须从零更改为组件的输入 ID。 如果您创建的是具有异步输出的组件，则每个输出的 SynchronousInputID 属性必须设置为零。因此，第一个输出的 SynchronousInputID 值必须从组件的输入 ID 更改为零。

有关在脚本组件中将行定向到两个同步输出之一的示例，请参阅使用脚本组件创建同步转换。

脚本组件会分析输入和输出的名称，还会分析输入和输出中的列的名称，并基于这些名称在 BufferWrapper 项目项中生成类和属性。如果找到的名称包含不属于 Unicode 类别 UppercaseLetter、LowercaseLetter、TitlecaseLetter、ModifierLetter、OtherLetter 或 DecimalDigitLetter 的字符，则生成的名称中的无效字符将被删除。例如，空格将被删除，因此名称为 FirstName 和 [First Name] 的两个输入列都会解释为具有列名 FirstName，从而产生不可预测的结果。为了避免发生这种情况，脚本组件所使用的输入和输出的名称以及输入列和输出列的名称应仅包含本部分列出的 Unicode 类别中的字符。

在**“脚本任务编辑器”的“脚本”**页中，可以为脚本任务指定唯一的名称和说明。还可以为以下属性赋值。

注意
在 SQL Server 2008 Integration Services (SSIS) 中，所有脚本都要进行预编译。在早期版本中，通过设置任务的 Precompile 属性来指定是否对脚本进行预编译。

ValidateExternalMetadata 属性

ReadOnlyVariables 和 ReadWriteVariables 属性

可以输入以逗号分隔的现有变量列表作为这些属性的值，使这些变量在脚本组件代码中可用于只读或读/写访问。这些变量可在代码中通过自动生成的基类的 ReadOnlyVariables 和 ReadWriteVariables 属性来访问。有关详细信息，请参阅在脚本组件中使用变量。

注意
变量名称区分大小写。

ScriptLanguage

“编辑脚本”按钮

在**“脚本转换编辑器”的“连接管理器”**页中，可以添加和删除要在自定义脚本中使用的连接管理器。通常，创建源或目标组件时需要引用连接管理器。

在将要基于此元数据生成的代码项目中，ComponentWrapper 项目项包含一个 Connections 集合类，该类为每个所选连接管理器包含一个类型化取值函数属性。每个类型化取值函数属性的名称都与连接管理器本身的名称相同，该属性将返回对作为 IDTSConnectionManager100 实例的连接管理器的引用。例如，如果已在编辑器的**“连接管理器”**页中添加名为 MyADONETConnection 的连接管理器，则可在脚本中使用以下代码获取对该连接管理器的引用：

Dim myADONETConnectionManager As IDTSConnectionManager100 = _
    Me.Connections.MyADONETConnection

有关详细信息，请参阅在脚本组件中连接数据源。