Tablets.TabletsEnumerator.Current 屬性

發行項
10/29/2008

取得列舉值指向之 Tablets 集合內的 Tablet 物件。

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

語法

'宣告
Public ReadOnly Property Current As Tablet
'用途
Dim instance As Tablets..::.TabletsEnumerator
Dim value As Tablet

value = instance.Current

public Tablet Current { get; }

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

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

public function get Current () : Tablet

屬性值

型別：Microsoft.Ink.Tablet
列舉值指向之 Tablets 集合內的 Tablet 物件。

備註

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

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

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

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

範例

這個範例會對 Tablets 集合使用 IEnumerator，以便反覆查看 Tablets 集合 (變數名稱為 allTablets)，並且將附加至系統的每個手寫板裝置的名稱填入 ListBox (英文) 物件 (變數名稱為 listBoxTablets)。

' Calling the constructor automatically fills the 
' Tablets collection with the available Tablet objects.
Dim allTablets As Tablets = New Tablets()

' clear the list box
Me.listBoxTablets.Items.Clear()

' populate the list box with the name of each tablet
' version using GetEnumerator()
Dim theTabletsEnumerator As IEnumerator = allTablets.GetEnumerator()
While (theTabletsEnumerator.MoveNext())
    Dim T As Tablet = theTabletsEnumerator.Current
    Me.listBoxTablets.Items.Add(T.Name)
End While

// Calling the constructor automatically fills the 
// Tablets collection with the available Tablet objects.
Tablets allTablets = new Tablets();

// clear the list box
this.listBoxTablets.Items.Clear();

// populate the list box with the name of each tablet
// version using GetEnumerator()
IEnumerator theTabletsEnumerator = allTablets.GetEnumerator();
while (theTabletsEnumerator.MoveNext())
{
    Tablet T = (Tablet)theTabletsEnumerator.Current;
    this.listBoxTablets.Items.Add(T.Name);
}