Tablets.TabletsEnumerator.Current (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

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

value = instance.Current

public Tablet Current { get; }

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

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

public function get Current () : Tablet

Valor de propiedad

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

Comentarios

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

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 permanece inalterada. 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 usa la interfaz IEnumerator de la colección Tablets para recorrer en iteración la colección Tablets, allTablets, y rellenar el objeto ListBoxlistBoxTablets con los nombres de cada dispositivo Tablet PC conectado al sistema.

' Calling the constructor automatically fills the 
' Tablets collection with the available Tablet objects.
Dim allTablets As Tablets = New Tablets()

' clear the list box
Me.listBoxTablets.Items.Clear()

' populate the list box with the name of each tablet
' version using GetEnumerator()
Dim theTabletsEnumerator As IEnumerator = allTablets.GetEnumerator()
While (theTabletsEnumerator.MoveNext())
    Dim T As Tablet = theTabletsEnumerator.Current
    Me.listBoxTablets.Items.Add(T.Name)
End While

// Calling the constructor automatically fills the 
// Tablets collection with the available Tablet objects.
Tablets allTablets = new Tablets();

// clear the list box
this.listBoxTablets.Items.Clear();

// populate the list box with the name of each tablet
// version using GetEnumerator()
IEnumerator theTabletsEnumerator = allTablets.GetEnumerator();
while (theTabletsEnumerator.MoveNext())
{
    Tablet T = (Tablet)theTabletsEnumerator.Current;
    this.listBoxTablets.Items.Add(T.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.