Recognizers.RecognizersEnumerator.Current プロパティ

2008-10-28

列挙子が指している 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 プロパティにより例外がスローされます。MoveNext メソッドの前回の呼び出しで false が返された場合、列挙子は Recognizers コレクションの末尾に到達します。

Current プロパティは、列挙子の位置を移動しません。Current プロパティを連続して呼び出した場合、MoveNext メソッドまたは Reset メソッドが呼び出されるまでは同じオブジェクトが返されます。

コレクションが変更されない限り、列挙子は有効なままです。要素の追加、変更、削除などの変更がコレクションに対して実行されると、列挙子は回復不可能な無効状態になります。MoveNext メソッドまたは Reset メソッドの次の呼び出しで、InvalidOperationException 例外がスローされます。コレクションが 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);
}