DivisionUnits.InkDivisionUnitsEnumerator.Current 屬性

發行項
10/29/2008

取得 DivisionUnits 集合中的 DivisionUnit 物件，列舉值會指向前者。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public ReadOnly Property Current As DivisionUnit
'用途
Dim instance As DivisionUnits..::.InkDivisionUnitsEnumerator
Dim value As DivisionUnit

value = instance.Current

public DivisionUnit Current { get; }

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

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

public function get Current () : DivisionUnit

屬性值

型別：Microsoft.Ink.DivisionUnit
DivisionUnits 集合中的 DivisionUnit 物件，列舉值會指向前者。

備註

在建立 DivisionUnits.InkDivisionUnitsEnumerator 列舉值或呼叫 Reset 方法之後，必須呼叫 MoveNext 方法使列舉值向前移至集合的第一個元素，才能讀取 Current 屬性的值，否則 Current 會是未定義的。

如果上次呼叫 MoveNext 方法傳回 false，則 Current 屬性會擲回例外狀況。如果上次呼叫 MoveNext 方法時傳回 false，表示列舉值已經到達 DivisionUnits 集合的末端。

Current 屬性不會移動列舉值的位置。在呼叫 MoveNext 或 Reset 方法之前，對 Current 屬性的連續呼叫都會傳回相同的物件。

只要集合保持不變，列舉值將保持有效。如果對集合進行變更，例如加入、修改或刪除項目，則列舉值將失效且無法復原。下次呼叫 MoveNext 或 Reset 方法會擲回 System.InvalidOperationException (英文) 例外狀況。如果在呼叫 MoveNext 方法和呼叫 Current 屬性之間修改了集合，則 Current 屬性會傳回其所設定的元素，即使列舉值已經失效也一樣。

範例

這個範例會取得 DivisionUnits 集合的 System.Collections.IEnumerator (英文)，並用來列舉集合的每個項目。DivisionUnits 集合是由 DivisionResult.ResultByType 方法傳回。

Dim theRecognizedText As ArrayList = New ArrayList()
Dim theDivisionUnits As DivisionUnits = theDivisionResult.ResultByType(InkDivisionType.Paragraph)
Dim iEnum As System.Collections.IEnumerator = theDivisionUnits.GetEnumerator()
iEnum.Reset()
While iEnum.MoveNext()
    Dim theDivisionUnit As DivisionUnit = DirectCast(iEnum.Current, DivisionUnit)
    theRecognizedText.Add(theDivisionUnit.RecognitionString)
End While

ArrayList theRecognizedText = new ArrayList();
DivisionUnits theDivisionUnits = theDivisionResult.ResultByType(InkDivisionType.Paragraph);
System.Collections.IEnumerator iEnum = theDivisionUnits.GetEnumerator();
iEnum.Reset();
while (iEnum.MoveNext())
{
    DivisionUnit theDivisionUnit = (DivisionUnit)iEnum.Current;
    theRecognizedText.Add(theDivisionUnit.RecognitionString);
}