IDTSCustomPropertyCollection100.GetEnumerator 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
public:
System::Collections::IEnumerator ^ GetEnumerator();[System.Runtime.InteropServices.DispId(-4)]
public System.Collections.IEnumerator GetEnumerator ();[<System.Runtime.InteropServices.DispId(-4)>]
abstract member GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumerator반환
사용자 지정 속성 컬렉션을 반복할 수 있는 IEnumerator 입니다.
구현
- 특성
설명
열거자는 컬렉션의 데이터 읽기를 허용 합니다. 내부 컬렉션을 수정 하 여 열거자를 사용할 수 없습니다.
처음에 열거자는 컬렉션의 첫 번째 요소 앞에 배치됩니다. 또한 다시 설정 하면 열거자가 이 위치로 돌아갑니다. 이 위치에서 Current 를 호출하면 예외가 throw됩니다. 따라서 Current 값을 읽기 전에 MoveNext를 호출하여 열거자를 컬렉션의 첫 번째 요소로 이동해야 합니다.
현재 는 MoveNext 또는 Reset 이 호출될 때까지 동일한 개체를 반환합니다. MoveNext는현재 를 다음 요소로 설정합니다.
컬렉션의 끝을 전달한 후 열거자는 컬렉션의 마지막 요소 앞에 배치되고 MoveNext 를 호출하면 false가 반환됩니다. MoveNext에 대한 마지막 호출이 false를 반환하면 Current를 호출하면 예외가 throw됩니다. Current를 컬렉션의 첫 번째 요소로 다시 설정하려면 Reset을 호출한 다음 MoveNext를 호출할 수 있습니다.
컬렉션이 변경되지 않고 그대로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 요소 추가, 수정 또는 삭제와 같이 컬렉션이 변경되면 열거자가 취소할 수 없게 무효화되고 MoveNext 또는 Reset 에 대한 다음 호출은 InvalidOperationException을 throw합니다. MoveNext와 Current 간에 컬렉션이 수정되면 열거자가 이미 무효화된 경우에도 현재 컬렉션이 설정된 요소를 반환합니다.
열거자는 컬렉션에 배타적으로 액세스하지 못하므로 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다. 컬렉션이 동기화되어 있을 때 다른 스레드에서 해당 컬렉션을 수정할 수 있으므로 이렇게 되면 열거자에서 예외가 throw됩니다. 열거하는 동안 스레드로부터 안전을 보장하려면 전체 열거를 수행하는 동안 컬렉션을 잠그거나 다른 스레드에서 변경된 내용으로 인해 발생한 예외를 catch하면 됩니다.