Recognizers.RecognizersEnumerator.Current (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene el objeto Recognizer de la colección Recognizers 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 Recognizer
'Uso
Dim instance As Recognizers..::.RecognizersEnumerator
Dim value As Recognizer

value = instance.Current

public Recognizer Current { get; }

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

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

public function get Current () : Recognizer

Valor de propiedad

Tipo: Microsoft.Ink.Recognizer
Objeto Recognizer de la colección Recognizers a la que señala el enumerador.

Comentarios

Después de crear un enumerador Recognizers.RecognizersEnumerator, 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 Recognizers.

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 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 este ejemplo se obtiene la interfaz System.Collections.IEnumerator de la colección Recognizers y se utiliza para recorrer la colección.

' calling the constructor fills the collection with all known Recognizer objects
Dim allRecognizers As Recognizers = New Recognizers()
Dim recogNames As List(Of String) = New List(Of String)
Dim theEnumerator As IEnumerator = allRecognizers.GetEnumerator()
theEnumerator.Reset()
While (theEnumerator.MoveNext())
    Dim theRecognizer As Recognizer = DirectCast(theEnumerator.Current, Recognizer)
    recogNames.Add(theRecognizer.Name)
End While

// calling the constructor fills the collection with all known Recognizer objects
Recognizers allRecognizers = new Recognizers();
List<String> recogNames = new List<string>();
IEnumerator theEnumerator = allRecognizers.GetEnumerator();
theEnumerator.Reset();
while (theEnumerator.MoveNext())
{
    Recognizer theRecognizer = (Recognizer)theEnumerator.Current;
    recogNames.Add(theRecognizer.Name);
}

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.