CustomStrokes.CustomStrokesEnumerator.Current (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene la colección Strokes de la colección CustomStrokes a la que señala el enumerador.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public ReadOnly Property Current As Strokes
'Uso
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

Valor de propiedad

Tipo: Microsoft.Ink.Strokes
Colección Strokes de la colección CustomStrokes a la que señala el enumerador.

Comentarios

Después de crear un enumerador CustomStrokes.CustomStrokesEnumerator, o después de llamar al método Reset, es necesario llamar al método MoveNext para desplazar el enumerador hasta el primer elemento de la colección antes de leer el valor de la propiedad Current; de lo contrario, la propiedad Current queda sin definir.

La propiedad Current genera una excepción si la última llamada al método MoveNext devuelve false. Si la última llamada al método MoveNext devuelve false, significa que el enumerador ha llegado al final de la colección CustomStrokes.

La propiedad Current no desplaza la posición del enumerador. Las llamadas consecutivas a la propiedad Current devuelven el mismo objeto hasta que se llama a cualquiera de los métodos MoveNext o Reset.

Un enumerador es válido mientras la colección no experimenta cambios. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida definitivamente. La siguiente llamada al método MoveNext o Reset genera una excepción System.InvalidOperationException. Si se modifica la colección entre la llamada al método MoveNext y la llamada a la propiedad Current, la propiedad Current devuelve el elemento en el que se ha establecido, aunque el enumerador ya esté invalidado.

Ejemplos

En estos ejemplos se muestran dos formas de enumerar la colección CustomStrokes para recuperar cada uno de los objetos Strokes incluidos en la colección.

En este ejemplo se obtiene el objeto IEnumerator de la colección CustomStrokes y se utiliza para recorrer la colección. Cada objeto Strokes se ajusta mediante un factor de 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);
    }
}

En este ejemplo se utiliza la instrucción foreach, que llama al método GetEnumerator en el código interno que el compilador genera para admitir la instrucción.

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

}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.