Tablets.TabletsEnumerator.Current, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient l'objet Tablet dans la collection Tablets sur laquelle l'énumérateur pointe.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Current As Tablet
'Utilisation
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

Valeur de propriété

Type : Microsoft.Ink.Tablet
Objet Tablet dans la collection Tablets sur laquelle l'énumérateur pointe.

Notes

Après la création d'un énumérateur Tablets.TabletsEnumerator ou un appel à la méthode Reset, vous devez appeler la méthode MoveNext pour avancer l'énumérateur au premier élément de la collection avant la lecture de la valeur de la propriété Current ; sinon, la propriété Current n'est pas définie.

La propriété Current lève une exception si le dernier appel à la méthode MoveNext retourne false. Si le dernier appel à la méthode MoveNext retourne la valeur false, l'énumérateur a atteint la fin de la collection Tablets.

La propriété Current ne déplace pas l'énumérateur. Les appels consécutifs à la propriété Current retournent le même objet jusqu'à ce que la méthode MoveNext ou Reset soit appelée.

Un énumérateur reste valide aussi longtemps que la collection demeure inchangée. Si la collection est modifiée par l'ajout, la modification ou la suppression des éléments, l'énumérateur devient définitivement non valide. L'appel suivant à la méthode MoveNext ou Reset lève une exception InvalidOperationException (page pouvant être en anglais). Si la collection est modifiée entre l'appel à la méthode MoveNext et l'appel à la propriété Current, la propriété Current retourne l'élément défini comme sa valeur, même si l'énumérateur est déjà invalidé.

Exemples

Cet exemple utilise le IEnumerator (page pouvant être en anglais) pour la collection Tablets pour parcourir la collection Tablets, allTablets, et remplir l'objet ListBox (page pouvant être en anglais) listBoxTablets avec le nom de chaque périphérique de la tablette connectée au système.

' 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);
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.