ActivityCollection.GetEnumerator 메서드

정의

ICollection에 대한 열거형 인터페이스를 구현합니다.

public:
 System::Collections::Generic::IEnumerator<System::Workflow::ComponentModel::Activity ^> ^ GetEnumerator();
public System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity> GetEnumerator ();
override this.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity>
Public Function GetEnumerator () As IEnumerator(Of Activity)

반환

IEnumerator<Activity>

ReadOnlyCollectionBase 인스턴스에서 반복할 수 있는 열거자입니다.

구현

설명

열거자에서는 컬렉션의 데이터를 읽기만 할 수 있습니다. 열거자를 사용하여 내부 컬렉션을 수정할 수 없습니다.

처음에는 열거자가 컬렉션의 첫 번째 요소 앞에 위치합니다. Reset을 실행하면 열거자가 이 위치로 복원됩니다. 여기에서 Current를 호출하면 예외가 발생합니다. 따라서 MoveNext의 값을 읽기 전에 Current를 호출하여 열거자를 해당 컬렉션의 첫 번째 요소로 보내야 합니다.

Current에서는 MoveNext 또는 Reset이 호출될 때까지 동일한 개체를 반환합니다. MoveNextCurrent를 다음 요소로 설정합니다.

컬렉션의 끝이 전달된 후 열거자는 컬렉션의 마지막 요소 뒤에 배치되고 MoveNext를 호출하면 false가 반환됩니다. MoveNext에 대한 마지막 호출에서 false가 반환된 경우 Current를 호출하면 예외가 발생합니다.

Current를 컬렉션의 첫째 요소에 다시 설정하려면 Reset을 호출한 뒤 MoveNext를 호출해야 합니다.

컬렉션이 변경되지 않고 그대로 유지되는 한 열거자는 유효한 상태로 유지됩니다. 요소를 추가, 수정 또는 삭제하는 등 컬렉션을 변경하면 열거자가 무효로 되어 이를 다시 유효화할 수 없으며 다음에 MoveNext 또는 Reset을 호출할 때 InvalidOperationException이 발생합니다. MoveNextCurrent 사이에 컬렉션이 수정되면 열거자가 이미 무효로 되었어도 Current는 컬렉션이 설정된 요소를 반환합니다.

열거자는 컬렉션에 배타적으로 액세스하지 못하므로 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다. 컬렉션이 동기화된 경우에도 다른 스레드에서 컬렉션을 수정할 수 있습니다. 이렇게 하면 열거자가 예외를 발생시킵니다. 열거하는 동안 스레드로부터 안전을 보장하려면 전체 열거를 수행하는 동안 컬렉션을 잠그거나 다른 스레드에서 변경된 내용으로 인해 발생한 예외를 catch하면 됩니다.

적용 대상