DivisionUnits.InkDivisionUnitsEnumerator.Current (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

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

value = instance.Current

public DivisionUnit Current { get; }

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

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

public function get Current () : DivisionUnit

Valor de propiedad

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

Comentarios

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

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 este ejemplo, se obtiene la interfaz System.Collections.IEnumerator para la colección DivisionUnits y se usa para enumerar cada elemento de la colección. El método DivisionResult.ResultByType devuelve la colección DivisionUnits.

Dim theRecognizedText As ArrayList = New ArrayList()
Dim theDivisionUnits As DivisionUnits = theDivisionResult.ResultByType(InkDivisionType.Paragraph)
Dim iEnum As System.Collections.IEnumerator = theDivisionUnits.GetEnumerator()
iEnum.Reset()
While iEnum.MoveNext()
    Dim theDivisionUnit As DivisionUnit = DirectCast(iEnum.Current, DivisionUnit)
    theRecognizedText.Add(theDivisionUnit.RecognitionString)
End While

ArrayList theRecognizedText = new ArrayList();
DivisionUnits theDivisionUnits = theDivisionResult.ResultByType(InkDivisionType.Paragraph);
System.Collections.IEnumerator iEnum = theDivisionUnits.GetEnumerator();
iEnum.Reset();
while (iEnum.MoveNext())
{
    DivisionUnit theDivisionUnit = (DivisionUnit)iEnum.Current;
    theRecognizedText.Add(theDivisionUnit.RecognitionString);
}

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.