CustomStrokes.CustomStrokesEnumerator.Current, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection Strokes dans la collection CustomStrokes 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 Strokes
'Utilisation
Dim instance As CustomStrokes..::.CustomStrokesEnumerator
Dim value As Strokes

value = instance.Current

public Strokes Current { get; }

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

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

public function get Current () : Strokes

Valeur de propriété

Type : Microsoft.Ink.Strokes
Collection Strokes dans la collection CustomStrokes sur laquelle l'énumérateur pointe.

Notes

Après la création d'un énumérateur CustomStrokes.CustomStrokesEnumerator 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 CustomStrokes.

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 System.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à non valide.

Exemples

Ces exemples présentent deux façons d'énumérer la collection CustomStrokes pour récupérer chaque objet Strokes contenu dans la collection.

Cet exemple obtient le IEnumerator pour la collection CustomStrokes et l'utilise pour parcourir celle-ci. Chaque objet Strokes est mis à l'échelle par facteur 2.

Private Sub EnumerateCustomStrokesWithEnumerator(ByVal mInk As Ink)
    Dim mCustomStrokesEnumerator As IEnumerator = mInk.CustomStrokes.GetEnumerator()
    mCustomStrokesEnumerator.Reset()
    While (mCustomStrokesEnumerator.MoveNext())
        Dim S As Strokes = DirectCast(mCustomStrokesEnumerator.Current, Strokes)
        S.Scale(2, 2)
    End While
End Sub

private void EnumerateCustomStrokesWithEnumerator(Ink mInk)
{
    IEnumerator mCustomStrokesEnumerator = mInk.CustomStrokes.GetEnumerator();
    mCustomStrokesEnumerator.Reset();
    while (mCustomStrokesEnumerator.MoveNext())
    {
        Strokes S = (Strokes)mCustomStrokesEnumerator.Current;
        S.Scale(2, 2);
    }
}

Cet exemple utilise l'instruction foreach, qui appelle la méthode GetEnumerator dans le code interne que le compilateur génère pour prendre en charge l'instruction.

Private Sub EnumerateCustomStrokesWithForEach(ByVal mInk As Ink)
    For Each S As Strokes In mInk.CustomStrokes
        S.Scale(2, 2)
    Next
End Sub

private void EnumerateCustomStrokesWithForEach(Ink mInk)
{
    foreach (Strokes S in mInk.CustomStrokes)
    {
        S.Scale(2, 2);
    }

}

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.