WarningEnumerator.Current 속성

정의

네임스페이스:

Microsoft.SqlServer.Dts.Runtime

어셈블리:

Microsoft.SqlServer.ManagedDTS.dll

컬렉션에서 현재 DtsWarning 개체를 가져옵니다.

public:
 property Microsoft::SqlServer::Dts::Runtime::DtsWarning ^ Current { Microsoft::SqlServer::Dts::Runtime::DtsWarning ^ get(); };

public Microsoft.SqlServer.Dts.Runtime.DtsWarning Current { get; }

member this.Current : Microsoft.SqlServer.Dts.Runtime.DtsWarning

Public ReadOnly Property Current As DtsWarning

속성 값

DtsWarning

현재 DtsWarning 개체입니다.

예제

다음 코드 예제에서는 패키지에 작업을 추가한 다음 패키지를 실행합니다. 경고 컬렉션은 각 경고 설명을 만들고 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] 제목이 비어 있음

설명

열거자를 만든 후 또는 메서드 MoveNext 를 Reset 호출한 후 열거자가 속성 값을 Current 읽을 수 있기 전에 열거자를 컬렉션의 첫 번째 요소로 이동하려면 메서드를 호출해야 합니다. 그렇지 않으면 Current 정의되지 않고 예외를 throw합니다.

Current 마지막으로 호출 하는 경우 예외를 throw MoveNext 반환 false, 컬렉션의 끝을 나타내는입니다.

Current는 열거자의 위치를 이동하지 않으며, 같은 개체를 반환하기 위해 Current 연속 호출하거나 Reset 호출될 때까지 MoveNext 이 개체를 반환합니다.

컬렉션이 변경되지 않고 그대로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 요소 추가, 수정 또는 삭제와 같이 컬렉션이 변경되면 열거자가 무효화되어 복구할 수 없게 됩니다. 따라서 다음에 호출하거나 MoveNextReset throw합니다 InvalidOperationException. 호출 MoveNext 간에 CurrentCurrent 컬렉션이 수정된 경우 열거자가 무효화된 경우에도 컬렉션이 설정된 요소를 반환합니다.