Recognizers.RecognizersEnumerator.Current 속성

아티클
11/04/2008

업데이트: 2007년 11월

Recognizers 컬렉션에서 열거자가 가리키는 Recognizer 개체를 가져옵니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public ReadOnly Property Current As Recognizer
‘사용 방법
Dim instance As Recognizers..::.RecognizersEnumerator
Dim value As Recognizer

value = instance.Current

public Recognizer Current { get; }

public:
property Recognizer^ Current {
    Recognizer^ get ();
}

/** @property */
public Recognizer get_Current()

public function get Current () : Recognizer

속성 값

형식: Microsoft.Ink.Recognizer
Recognizers 컬렉션에서 열거자가 가리키는 Recognizer 개체입니다.

설명

Recognizers.RecognizersEnumerator 열거자를 만들었거나 Reset 메서드를 호출한 후에는 Current 속성 값을 읽기 전에 MoveNext 메서드를 호출하여 열거자를 컬렉션의 첫 번째 요소로 이동해야 합니다. 이렇게 하지 않으면 Current 속성이 정의되지 않습니다.

MoveNext 메서드를 마지막으로 호출할 때 false가 반환된 경우 Current 속성에서 예외가 throw됩니다. MoveNext 메서드를 마지막으로 호출할 때 false가 반환된 경우 열거자가 Recognizers 컬렉션의 끝에 도달한 것입니다.

Current 속성은 열거자의 위치를 이동하지 않습니다. Current 속성을 연속해서 호출하면 MoveNext 또는 Reset 메서드가 호출될 때까지 동일한 개체가 반환됩니다.

열거자는 컬렉션이 변경되지 않은 상태로 유지되는 한 유효합니다. 요소를 추가, 수정 또는 삭제하는 등 컬렉션을 변경하면 열거자가 무효화되며 이러한 상태를 복구할 수 없습니다. 다음 번에 MoveNext 또는 Reset 메서드를 호출하면 InvalidOperationException 예외가 throw됩니다. MoveNext 메서드를 호출하는 시점과 Current 속성을 호출하는 시점 사이에서 컬렉션이 수정된 경우 Current 속성은 열거자가 이미 무효화된 경우에도 자신이 가리키는 요소를 반환합니다.

예제

이 예제에서는 Recognizers 컬렉션의 System.Collections.IEnumerator를 가져와서 컬렉션을 순회하는 데 사용합니다.

' calling the constructor fills the collection with all known Recognizer objects
Dim allRecognizers As Recognizers = New Recognizers()
Dim recogNames As List(Of String) = New List(Of String)
Dim theEnumerator As IEnumerator = allRecognizers.GetEnumerator()
theEnumerator.Reset()
While (theEnumerator.MoveNext())
    Dim theRecognizer As Recognizer = DirectCast(theEnumerator.Current, Recognizer)
    recogNames.Add(theRecognizer.Name)
End While

// calling the constructor fills the collection with all known Recognizer objects
Recognizers allRecognizers = new Recognizers();
List<String> recogNames = new List<string>();
IEnumerator theEnumerator = allRecognizers.GetEnumerator();
theEnumerator.Reset();
while (theEnumerator.MoveNext())
{
    Recognizer theRecognizer = (Recognizer)theEnumerator.Current;
    recogNames.Add(theRecognizer.Name);
}