MatchCollection.IEnumerable<Match>.GetEnumerator 메서드

정의

네임스페이스:

System.Text.RegularExpressions

어셈블리:

System.Text.RegularExpressions.dll

Source:

MatchCollection.cs

컬렉션을 반복하는 열거자를 반환합니다.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>

Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumerator

반환

IEnumerator<Match>

컬렉션을 반복하는 데 사용할 수 있는 열거자입니다.

구현

GetEnumerator()

예외

NotSupportedException

컬렉션이 읽기 전용입니다.

설명

반환 IEnumerator<T> 된 속성을 노출 하여 컬렉션을 반복 하는 기능을 제공 합니다 Current . 열거자를 사용하여 컬렉션의 데이터를 읽을 수 있지만 컬렉션을 수정할 수는 없습니다. 처음에 열거자는 컬렉션의 첫 번째 요소 앞에 배치됩니다. 이 위치에서 Current는 정의되지 않습니다. 따라서 호출 해야 합니다 MoveNext 해당 열거자의 값을 읽기 전에 컬렉션의 첫 번째 요소를 이동 하는 방법 Current합니다. Current는 가 다음 요소에 대한 집합 Current 으로 MoveNext 다시 호출될 때까지 MoveNext 동일한 개체를 반환합니다. 경우 MoveNext 열거자를 컬렉션의 끝 컬렉션의 마지막 요소 뒤에 배치 되는 전달 하 고 MoveNext 반환 false합니다. 열거자가 있는 경우이 위치에 대 한 후속 호출은 MoveNext 반환할 수도 false합니다. 반환 falseCurrent 된 에 대한 MoveNext 마지막 호출이 정의되지 않은 경우 Current를 컬렉션의 첫 번째 요소로 다시 설정할 수 없으므로 대신 새 열거자 인스턴스를 만들어야 합니다. 요소 추가, 수정 또는 삭제와 같이 컬렉션이 변경되면 열거자의 동작이 정의되지 않습니다. 열거자는 컬렉션에 대한 단독 액세스 권한이 없으므로 컬렉션이 변경되지 않는 한 열거자는 유효한 상태를 유지합니다. 요소 추가, 수정 또는 삭제와 같이 컬렉션이 변경되면 열거자가 무효화되고 예기치 않은 결과가 발생할 수 있습니다. 또한 컬렉션을 열거하는 것은 스레드로부터 안전한 프로시저가 아닙니다. 스레드 안전을 보장하려면 열거자 중에 컬렉션을 잠그거나 컬렉션에서 동기화를 구현해야 합니다. 네임스페이스에 있는 System.Collections.Generic 컬렉션의 기본 구현은 동기화되지 않습니다.