通过

  • 项目

创建自定义 Foreach 枚举器

创建自定义 foreach 枚举器的步骤与创建其他任何 Integration Services 自定义对象的步骤相似。

  • 创建一个从基类继承的新类。对于 foreach 枚举器，基类是 ForEachEnumerator。

  • 将标识对象类型的属性应用于该类。对于 foreach 枚举器，该属性为 DtsForEachEnumeratorAttribute。

  • 重写基类的方法和属性的实现。对于 foreach 枚举器，最重要的是 GetEnumerator 方法。

  • 可以选择开发自定义用户界面。对于 foreach 枚举器，这需要实现 IDTSForEachEnumeratorUI 接口的类。

自定义枚举器由 ForEachLoop 容器承载。在运行时，ForEachLoop 容器会调用自定义枚举器的 GetEnumerator 方法。自定义枚举器会返回一个实现 IEnumerable 接口的对象，如 ArrayList。ForEachLoop 随后循环访问该集合中的每个元素，并通过一个用户定义的变量将当前元素的值提供给控制流，然后在容器中执行控制流。

有关自定义枚举器的工作示例，请参阅 Codeplex 上的 Integration Services 示例。

自定义 ForEach 枚举器入门

创建项目和类

由于所有托管 foreach 枚举器都是从基类 ForEachEnumerator 派生的，因此创建自定义 foreach 枚举器的第一步是创建一个用您首选的托管编程语言编写的类库项目，然后创建一个从该基类继承的类。在此派生类中重写基类的属性和方法可实现您的自定义功能。

在同一解决方案中，创建另一个类库项目，用于自定义用户界面。为便于部署，推荐对用户界面使用单独的程序集，因为这样，您就可以分别更新和重新部署 foreach 枚举器或其用户界面。

将这两个项目配置为使用强名称密钥文件对在生成时产生的程序集进行签名。

应用 DtsForEachEnumerator 属性

将 DtsForEachEnumeratorAttribute 属性应用于您创建的类以将其标识为 foreach 枚举器。此属性提供设计时信息，如 foreach 枚举器的名称和说明。Name 属性将显示在**“Foreach 循环编辑器”对话框的“集合”**选项卡上的可用枚举器下拉列表中。

使用 UITypeName 属性链接 foreach 枚举器与其自定义用户界面。若要获取此属性所需的公钥标记，可以使用 sn.exe -t 显示要用于对用户界面程序集进行签名的密钥对 (.snk) 文件中的公钥标记。

Imports System
Imports Microsoft.SqlServer.Dts.Runtime
Namespace Microsoft.Samples.SqlServer.Dts
    <DtsForEachEnumerator(DisplayName = "MyEnumerator", Description="A sample custom enumerator", UITypeName="FullyQualifiedTypeName,AssemblyName,Version=1.00.000.00,Culture=Neutral,PublicKeyToken=<publickeytoken>")> _ 
    Public Class MyEnumerator
     Inherits ForEachEnumerator
        'Insert code here.
    End Class
End Namespace

using System;
using Microsoft.SqlServer.Dts.Runtime;
namespace Microsoft.Samples.SqlServer.Dts
{
    [DtsForEachEnumerator( DisplayName = "MyEnumerator", Description="A sample custom enumerator", UITypeName="FullyQualifiedTypeName,AssemblyName,Version=1.00.000.00,Culture=Neutral,PublicKeyToken=<publickeytoken>")]
    public class MyEnumerator : ForEachEnumerator
    {
        //Insert code here.
    }
}

生成、部署和调试自定义枚举器

在 Integration Services 中生成、部署和调试自定义 foreach 枚举器的步骤与其他自定义对象类型所需的步骤非常相似。有关详细信息，请参阅生成、部署和调试自定义对象。

Integration Services 图标(小) 使 Integration Services 保持最新

若要从 Microsoft 获得最新的下载内容、文章、示例和视频，以及从社区获得所选解决方案，请访问 MSDN 或 TechNet 上的 Integration Services 页：

若要获得有关这些更新的自动通知，请订阅该页上提供的 RSS 源。