RecognitionAlternates.RecognitionAlternatesEnumerator.Current 属性

项目
11/04/2008

获取枚举数指向的 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 方法后，必须先通过调用 MoveNext 方法将枚举数前移到集合的第一个元素，然后才能读取 Current 属性的值；否则 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());
}