Developing a Custom ForEach Enumerator
New: 14 April 2006
Integration Services uses foreach enumerators to iterate over the items in a collection and perform the same tasks for each element. Integration Services includes a variety of foreach enumerators that support the most commonly used collections, such as all the files in a folder, all the tables in a database, or all the elements of a list stored in a package variable. If the foreach enumerators and collections that are provided do not entirely meet your requirements, you can create a custom foreach enumerator.
To create a custom foreach enumerator, you have to create a class that inherits from the ForEachEnumerator base class, apply the DtsForEachEnumeratorAttribute attribute to your new class, and override the important methods and properties of the base class, including the GetEnumerator method.
For a working sample of a custom foreach enumerator, see the ForEachDirectory Sample.
In This Section
This section describes how to create, configure, and code a custom foreach enumerator and its custom user interface.
| Topic | Description |
|---|---|
Describes how to create the classes for a custom foreach enumerator project. |
|
Describes how to implement a custom foreach enumerator by overriding the methods and properties of the base class. |
|
Describes how to implement the user interface class and the form that is used to configure the custom foreach enumerator. |
Related Topics
For information that is common to all the type of custom objects that you can create in Integration Services, see the following topics.
| Topic | Description |
|---|---|
Describes the basic steps in implementing all types of custom objects for Integration Services. |
|
Describes custom persistence and explains when it is necessary. |
|
Describes the techniques for building, signing, deploying, and debugging custom objects. |
For information on the other types of custom objects that you can create in Integration Services, see the following topics.
| Topic | Description |
|---|---|
Discusses how to program custom tasks. |
|
Discusses how to program custom connection managers. |
|
Discusses how to program custom log providers. |
|
Discusses how to program custom data flow sources, transformations, and destinations. |