Proprietà CustomStrokes.CustomStrokesEnumerator.Current

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene l'insieme Strokes nell'insieme CustomStrokes a cui punta l'enumeratore.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property Current As Strokes
'Utilizzo
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

Valore proprietà

Tipo: Microsoft.Ink.Strokes
Insieme Strokes nell'insieme CustomStrokes a cui punta l'enumeratore.

Note

Dopo avere creato un enumeratore CustomStrokes.CustomStrokesEnumerator o dopo avere chiamato il metodo Reset, è necessario chiamare il metodo MoveNext per spostare l'enumeratore sul primo elemento dell'insieme prima di leggere il valore della proprietà Current. In caso contrario, la proprietà Current non è definita.

La proprietà Current genera un'eccezione se l'ultima chiamata al metodo MoveNext restituisce false. Se l'ultima chiamata al metodo MoveNext restituisce false, l'enumeratore ha raggiunto la fine di CustomStrokes.

La proprietà Current non sposta la posizione dell'enumeratore. Le chiamate consecutive alla proprietà Current restituiscono lo stesso oggetto finché non viene chiamato il metodo MoveNext o Reset.

Un enumeratore rimane valido finché l'insieme rimane invariato. Se vengono apportate modifiche all'insieme, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, l'enumeratore viene invalidato in modo irreversibile. La chiamata successiva al metodo MoveNext o Reset genera un'eccezione System.nvalidOperationException. Se l'insieme viene modificato tra la chiamata al metodo MoveNext e la chiamata alla proprietà Current, la proprietà Current restituisce l'elemento sul quale è impostata, anche se l'enumeratore è già stato invalidato.

Esempi

In questi esempi vengono illustrati due modi per enumerare l'insieme CustomStrokes allo scopo di recuperare ogni oggetto Strokes contenuto nell'insieme.

In questo esempio si ottiene l'oggetto IEnumerator per l'insieme CustomStrokes e lo si utilizza per attraversare l'insieme. Ogni oggetto Strokes viene ridimensionato di un fattore 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);
    }
}

In questo esempio viene utilizzata l'istruzione foreach che chiama il metodo GetEnumerator nel codice interno generato dal compilatore per supportare l'istruzione.

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

}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.