사용자 지정 Foreach 열거자 만들기

아티클
07/04/2024

적용 대상: Azure Data Factory의 SQL Server SSIS Integration Runtime

사용자 지정 foreach 열거자를 만드는 단계는 Integration Services에 대한 다른 사용자 지정 개체를 만드는 단계와 유사합니다.

기본 클래스에서 상속되는 새 클래스를 만듭니다. foreach 열거자의 경우 기본 클래스는 .입니다 ForEachEnumerator.
개체 유형을 식별하는 특성을 클래스에 적용합니다. foreach 열거자의 경우 특성은 .입니다 DtsForEachEnumeratorAttribute.
기본 클래스의 메서드 및 속성 구현을 재정의합니다. foreach 열거자의 경우 가장 중요한 것은 메서드입니다 GetEnumerator .
필요한 경우 사용자 지정 사용자 인터페이스를 개발합니다. foreach 열거자의 경우 인터페이스를 구현하는 클래스가 IDTSForEachEnumeratorUI 필요합니다.

사용자 지정 열거자는 ForEachLoop 컨테이너에 의해 호스팅됩니다. 런타임에 컨테이너는 ForEachLoop 사용자 지정 열거자의 메서드를 호출 GetEnumerator 합니다. 사용자 지정 열거자는 ArrayList와 같은 IEnumerable 인터페이스를 구현하는 개체를 반환합니다. 그런 ForEachLoop 다음 컬렉션의 각 요소를 반복하고, 사용자 정의 변수를 통해 제어 흐름에 현재 요소의 값을 제공하고, 컨테이너에서 제어 흐름을 실행합니다.

사용자 지정 ForEach 열거자 시작

프로젝트 및 클래스 만들기

관리되는 foreach 열거자는 모두 ForEachEnumerator 기본 클래스에서 파생되므로 사용자 지정 foreach 열거자를 만들려면 먼저 관리되는 프로그래밍 언어로 클래스 라이브러리 프로젝트를 만들고 기본 클래스에서 상속되는 클래스를 만들어야 합니다. 이 파생 클래스에서 기본 클래스의 메서드 및 속성을 재정의하여 사용자 지정 기능을 구현합니다.

동일한 솔루션에서 사용자 지정 사용자 인터페이스에 대한 두 번째 클래스 라이브러리 프로젝트를 만듭니다. 배포를 쉽게 하려면 사용자 인터페이스에 대한 별도의 어셈블리를 만드는 것이 좋습니다. 이렇게 하면 foreach 열거자 또는 해당 사용자 인터페이스를 독립적으로 업데이트하거나 다시 배포할 수 있기 때문입니다.

강력한 이름 키 파일을 사용하여 빌드 시 생성되는 어셈블리에 서명하도록 두 프로젝트를 구성합니다.

DtsForEachEnumerator 특성 적용

앞에서 만든 클래스에 DtsForEachEnumeratorAttribute 특성을 적용하여 해당 클래스를 foreach 열거자로 식별합니다. 이 특성은 foreach 열거자의 이름 및 설명과 같은 디자인 타임 정보를 제공합니다. 이름 속성은 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 열거자를 빌드, 배포 및 디버깅하는 단계는 다른 유형의 사용자 지정 개체에 필요한 단계와 매우 유사합니다. 자세한 내용은 사용자 지정 개체 빌드, 배포 및 디버깅을 참조 하세요.

참고 항목

사용자 지정 Foreach 열거자 코딩
사용자 지정 ForEach 열거자에 대한 사용자 인터페이스 개발

다음을 통해 공유