DtsEnumerator.Current 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컬렉션의 현재 요소를 가져옵니다.
public:
property System::Object ^ Current { System::Object ^ get(); };public object Current { get; }member this.Current : objPublic ReadOnly Property Current As Object속성 값
컬렉션의 현재 요소입니다.
구현
예제
다음 코드 예시는 패키지에 작업을 추가한 후 패키지를 실행하는 방식입니다. 경고 컬렉션은 이 DtsEnumerator 클래스에서 상속받은 를 생성WarningEnumerator하여 생성되며, 각 경고 설명과 컬렉션 내 경고를 검토하는 메서드를 사용 MoveNextCurrent 해 표시합니다.
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] 주어가 비어 있습니다
설명
열거자가 생성되거나 메서드를 Reset 호출한 후, MoveNext 메서드를 호출하여 집합의 첫 번째 요소로 진행시켜야 하며 Current, 그 후 의 값을 읽어야 합니다; 그렇지 않으면 Current 정의되지 않습니다.
Current는 컬렉션의 끝을 나타내는 반환MoveNext된 false 마지막 호출인 경우 예외를 throw합니다.
Current열거자의 위치를 이동시키지 않으므로, 또는 중 하나 MoveNextReset 가 호출될 때까지 같은 객체를 연속적으로 반환하게 Current 됩니다.
컬렉션이 변경되지 않은 상태로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 컬렉션에 요소를 추가, 수정 또는 삭제하여 변경이 발생하면, 열거자는 복구할 수 없게 무효화되며 다음에 MoveNext 또는 Reset을 호출할 때 InvalidOperationException 예외가 발생합니다. 컬렉션이 수정된 경우 MoveNextCurrentCurrent 열거자가 이미 무효화된 경우에도 컬렉션이 설정된 요소를 반환합니다.