DtsEnumerator 클래스

정의

네임스페이스:: Microsoft.SqlServer.Dts.Runtime

어셈블리:: Microsoft.SqlServer.ManagedDTS.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

IEnumerator 메서드를 구현하는 추상 기본 클래스를 정의합니다.

public ref class DtsEnumerator abstract : System::Collections::IEnumerator

public abstract class DtsEnumerator : System.Collections.IEnumerator

type DtsEnumerator = class
    interface IEnumerator

Public MustInherit Class DtsEnumerator
Implements IEnumerator

상속: Object
DtsEnumerator

파생: Microsoft.SqlServer.Dts.Runtime.BreakpointTargetEnumerator

Microsoft.SqlServer.Dts.Runtime.ConfigurationEnumerator

Microsoft.SqlServer.Dts.Runtime.ConnectionEnumerator

Microsoft.SqlServer.Dts.Runtime.ConnectionInfoEnumerator

Microsoft.SqlServer.Dts.Runtime.DBProviderInfoEnumerator

자세히…

구현: IEnumerator

예제

다음 코드 예시는 패키지에 작업을 추가한 후 패키지를 실행하는 방식입니다. 경고 모음은 이 DtsEnumerator 클래스에서 상속받은 를 생성WarningEnumerator하여 각 경고 설명을 표시합니다.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package package = new Package();  
            Console.WriteLine("Package warnings count before running: {0}", package.Warnings.Count);  

            TaskHost taskH2 = (TaskHost)package.Executables.Add("STOCK:SendMailTask");  
            taskH2.FailPackageOnFailure = false;  
            taskH2.FailParentOnFailure = false;  
            Console.WriteLine("SendMailTask: {0}", taskH2.ID);  

            // Test that warnings were successfully added to the collection.  
            package.MaximumErrorCount = 100;  
            package.FailPackageOnFailure = false;  
            package.FailParentOnFailure = false;  
            package.DelayValidation = true;  
            package.Execute();  

            Console.WriteLine("Package warnings count after running the package: {0}", package.Warnings.Count);  

            // Create the enumerator.  
            WarningEnumerator myEnumerator = package.Warnings.GetEnumerator();  
            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            while ((myEnumerator.MoveNext()) && (myEnumerator.Current != null))  
                Console.WriteLine("[{0}] {1}", i++, myEnumerator.Current.Description);  
        }  
    }  
}

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim package As Package =  New Package()   
            Console.WriteLine("Package warnings count before running: {0}", package.Warnings.Count)  

            Dim taskH2 As TaskHost = CType(package.Executables.Add("STOCK:SendMailTask"), TaskHost)  
            taskH2.FailPackageOnFailure = False  
            taskH2.FailParentOnFailure = False  
            Console.WriteLine("SendMailTask: {0}", taskH2.ID)  

            ' Test that warnings were successfully added to the collection.  
            package.MaximumErrorCount = 100  
            package.FailPackageOnFailure = False  
            package.FailParentOnFailure = False  
            package.DelayValidation = True  
            package.Execute()  

            Console.WriteLine("Package warnings count after running the package: {0}", package.Warnings.Count)  

            ' Create the enumerator.  
            Dim myEnumerator As WarningEnumerator =  package.Warnings.GetEnumerator()   
            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            While (myEnumerator.MoveNext()) &&(myEnumerator.Current <> Nothing)  
                Console.WriteLine("[{0}] {1}",i = Console.WriteLine("[{0}] {1}",i + 1  
            End While  
        End Sub  
    End Class  
End Namespace

샘플 출력:

패키지 경고 실행 전에는 0

SendMailTask: {34CAEFF9-64BF-401D-B646-C88B705DB971}

패키지 경고는 패키지 실행 후 2개

이 수집품에는 다음과 같은 값들이 포함되어 있습니다:

[0] 발신자 행의 주소가 올바르게 작성되지 않았습니다. @이 없거나 유효하지 않은 경우입니다.

[1] 주어가 비어 있습니다

설명

DtsEnumerator 는 모든 열거기의 기본 인터페이스입니다. 이 기능은 DtsEnumerator 컬렉션 내 데이터만 읽을 수 있게 하며, 기본 컬렉션을 수정하는 데는 사용되지 않습니다.

처음에는 열거자가 컬렉션의 첫 번째 요소 앞에 배치됩니다. Reset 또한 열거자를 이 위치로 다시 가져옵니다. 이 위치에서 호출 Current 은 예외를 throw합니다. 따라서 값을 MoveNext읽기 전에 열거자를 컬렉션의 첫 번째 요소로 이동하도록 호출 Current 해야 합니다.

Current 는 호출될 때까지 동일한 개체를 MoveNext Reset 반환합니다. MoveNext 는 다음 요소로 설정 Current 됩니다.

컬렉션의 끝을 전달한 후 열거자는 컬렉션의 마지막 요소 다음으로 배치되고 호출 MoveNext 은 반환됩니다 false. 반환MoveNext된 false 마지막 호출이 있으면 호출 Current 에서 예외가 throw됩니다. 컬렉션의 첫 번째 요소로 다시 설정 Current 하려면 다음Reset을 호출 MoveNext 할 수 있습니다.

컬렉션이 변경되지 않은 상태로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 컬렉션에 요소를 추가, 수정 또는 삭제하여 변경이 발생하면, 열거자는 복구할 수 없게 무효화되며 다음에 MoveNext 또는 Reset을 호출할 때 InvalidOperationException 예외가 발생합니다. 컬렉션이 수정된 경우 MoveNext Current Current 열거자가 이미 무효화된 경우에도 컬렉션이 설정된 요소를 반환합니다.

조사자는 컬렉션에 독점적으로 접근할 수 있는 것은 아닙니다; 따라서 컬렉션을 열거하는 것은 스레드 안전 절차가 아닙니다. 컬렉션이 동기화된 경우에도 다른 스레드는 컬렉션을 수정할 수 있으므로 열거자가 예외를 throw합니다. 열거 중 스레드 안전을 보장하기 위해 전체 열거 동안 컬렉션을 잠그거나 다른 스레드가 변경한 예외를 포착할 수 있습니다.

생성자

Name	Description
DtsEnumerator(IEnumerator, DTSReadOnlyCollectionBase)	DtsEnumerator 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
Current	컬렉션의 현재 요소를 가져옵니다.

메서드

Name	Description
MoveNext()	열거자를 컬렉션의 다음 요소로 진행합니다.
Reset()	열거자를 컬렉션의 첫 번째 요소 앞에 있는 초기 위치로 설정합니다.

적용 대상