ExtendedPropertyEnumerator.Current 속성

정의

네임스페이스:

Microsoft.SqlServer.Dts.Runtime

어셈블리:

Microsoft.SqlServer.ManagedDTS.dll

컬렉션에서 현재 ExtendedProperty 개체를 반환합니다.

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

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

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

Public ReadOnly Property Current As ExtendedProperty

속성 값

ExtendedProperty

현재 ExtendedProperty 개체입니다.

예제

다음 코드 샘플에서는 열거자를 만든 다음 MoveNext 메서드와 MoveNext 메서드를 사용하여 Current 컬렉션을 탐색합니다.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
namespace ExtendedProperties_Testing  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // The package is one of the SSIS Samples.  
            string mySample = @"C:\Program Files\Microsoft SQL Server\100\Tools\Samples\1033\DataTransformationServices\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";  
            // Create the Application, and load the sample.  
            Application app = new Application();  
            Package pkg = app.LoadPackage(mySample, null);  

            // Get the Extended properties collection from the package.  
            ExtendedProperties myExtProps = pkg.ExtendedProperties;  
            //Create the Enumerator.  
            ExtendedPropertyEnumerator myEnumerator = myExtProps.GetEnumerator();  

            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            ExtendedProperty myExtProp;  
            while ((myEnumerator.MoveNext()) && (myEnumerator.Current != null))  
            {  
                myExtProp = (ExtendedProperty)myEnumerator.Current;  
                Console.WriteLine("[{0}] {1}, {2}", i++, myExtProp.ID, myExtProp.DataType);  
                Console.WriteLine("------------------------------");  
            }  
            // Reset puts the index pointer before the beginning.  
            // Do not retrieve from the collection until MoveNext is called.  
            myEnumerator.Reset();  
            myEnumerator.MoveNext();  

            // Now that the enumerator has been reset, and moved to the  
            // first item in the collection, show the first item.  
            myExtProp = (ExtendedProperty)myEnumerator.Current;  
            Console.WriteLine("The first item in the enumerator after Reset:");  
            Console.WriteLine("{0}, {1}", myExtProp.ID, myExtProp.DataType);  
            Console.WriteLine();  
        }  
    }  
}  

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

Namespace ExtendedProperties_Testing  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            ' The package is one of the SSIS Samples.  
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\100\Tools\Samples\1033\DataTransformationServices\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"   
            ' Create the Application, and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   

            ' Get the Extended properties collection from the package.  
            Dim myExtProps As ExtendedProperties =  pkg.ExtendedProperties   
            'Create the Enumerator.  
            Dim myEnumerator As ExtendedPropertyEnumerator =  myExtProps.GetEnumerator()   

            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            Dim myExtProp As ExtendedProperty  
            While (myEnumerator.MoveNext()) &&(myEnumerator.Current <> Nothing)  
                myExtProp = CType(myEnumerator.Current, ExtendedProperty)  
                Console.WriteLine("[{0}] {1}, {2}",i = Console.WriteLine("[{0}] {1}, {2}",i + 1  
                Console.WriteLine("------------------------------")  
            End While  
            ' Reset puts the index pointer before the beginning.  
            ' Do not retrieve from the collection until MoveNext is called.  
            myEnumerator.Reset()  
            myEnumerator.MoveNext()  

            ' Now that the enumerator has been reset, and moved to the  
            ' first item in the collection, show the first item.  
            myExtProp = CType(myEnumerator.Current, ExtendedProperty)  
            Console.WriteLine("The first item in the enumerator after Reset:")  
            Console.WriteLine("{0}, {1}", myExtProp.ID, myExtProp.DataType)  
            Console.WriteLine()  
        End Sub  
    End Class  
End Namespace  

샘플 출력:

컬렉션에는 다음 값이 포함됩니다.

[0] {F3B7314E-DB1E-4CCA-A856-2E617A1B3265}, 문자열

------------------------------

[1] {AA947F2D-C3B3-420F-B39E-4B7C77DAAFC0}, String

------------------------------

[2] {AB2CCC33-3090-4C36-B444-5B50BB481324}, String

------------------------------

[3] {FE85601C-4ECC-41D4-BEAA-1318DDF7EE2A}, 문자열

------------------------------

[4] {4D1641B9-94EF-4144-9820-1B30ABD2214F}, 문자열

------------------------------

[5] {4E76A01C-BFF8-462D-AAB0-FB48B3EEAE00}, 문자열

------------------------------

[6] {A56842E2-11C1-487E-B670-33F25B534146}, 문자열

------------------------------

다시 설정 후 열거자의 첫 번째 항목:

{F3B7314E-DB1E-4CCA-A856-2E617A1B3265}, 문자열

설명

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

또한 컬렉션 의 끝을 나타내는 MoveNext에 대한 마지막 호출이 반환 false된 경우에도 현재는 예외를 throw합니다.

Current 는 열거자의 위치를 이동하지 않으며 Current에 대한 연속 호출은 MoveNext 또는 Reset 이 호출될 때까지 동일한 개체를 반환합니다.

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