RecognitionAlternates.RecognitionAlternatesEnumerator.Current プロパティ

2008-10-28

列挙子が指している RecognitionAlternates コレクション内の RecognitionAlternate オブジェクトを取得します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public ReadOnly Property Current As RecognitionAlternate
'使用
Dim instance As RecognitionAlternates..::.RecognitionAlternatesEnumerator
Dim value As RecognitionAlternate

value = instance.Current

public RecognitionAlternate Current { get; }

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

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

public function get Current () : RecognitionAlternate

プロパティ値

型 : Microsoft.Ink.RecognitionAlternate
列挙子が指している RecognitionAlternates コレクション内の RecognitionAlternate オブジェクト。

解説

RecognitionAlternates.RecognitionAlternatesEnumerator 列挙子を作成した後や Reset メソッドを呼び出した後に、コレクションの最初の要素に列挙子を進めるためには、Current プロパティの値を読み取る前に MoveNext メソッドを呼び出す必要があります。そうしない場合、Current プロパティは未定義になります。

MoveNext メソッドの前回の呼び出しで false が返された場合、Current プロパティにより例外がスローされます。MoveNext メソッドの前回の呼び出しで false が返された場合、列挙子は RecognitionAlternates コレクションの末尾に到達します。

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

コレクションが変更されない限り、列挙子は有効なままです。要素の追加、変更、削除などの変更がコレクションに対して実行されると、列挙子は回復不可能な無効状態になります。MoveNext メソッドまたは Reset メソッドの次の呼び出しで、InvalidOperationException 例外がスローされます。コレクションが MoveNext メソッドの呼び出しと Current プロパティの呼び出しとの間で変更された場合は、列挙子が既に無効になっていても、Current プロパティは設定した要素を返します。

例

この例では、RecognitionAlternates コレクション用に System.Collections.IEnumerator を取得し、これを使用してコレクションをスキャンします。

Dim inkRecogAlternates As List(Of String) = New List(Of String)
' get the RecognitionAlternates from the RecognitionResult object
Dim mAlternates As RecognitionAlternates = mRecognitionResult.GetAlternatesFromSelection()
' get the enumerator
Dim iEnum As RecognitionAlternates.RecognitionAlternatesEnumerator = mAlternates.GetEnumerator()
iEnum.Reset()
' traverse the collection
While iEnum.MoveNext()
    Dim theRecognitionAlternate As RecognitionAlternate = iEnum.Current
    inkRecogAlternates.Add(theRecognitionAlternate.ToString())
End While

List<String> inkRecogAlternates = new List<string>();
// get the RecognitionAlternates from the RecognitionResult object
RecognitionAlternates mAlternates = mRecognitionResult.GetAlternatesFromSelection();
// get the enumerator
RecognitionAlternates.RecognitionAlternatesEnumerator iEnum = mAlternates.GetEnumerator();
iEnum.Reset();
// traverse the collection
while (iEnum.MoveNext())
{
    RecognitionAlternate theRecognitionAlternate = iEnum.Current;
    inkRecogAlternates.Add(theRecognitionAlternate.ToString());
}