Proprietà RecognitionAlternates.RecognitionAlternatesEnumerator.Current

Aggiornamento: novembre 2007

Ottiene l'oggetto RecognitionAlternate nell'insieme RecognitionAlternates a cui punta l'enumeratore.

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

Sintassi

'Dichiarazione
Public ReadOnly Property Current As RecognitionAlternate
'Utilizzo
Dim instance As RecognitionAlternates..::.RecognitionAlternatesEnumerator
Dim value As RecognitionAlternate

value = instance.Current

public RecognitionAlternate Current { get; }

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

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

public function get Current () : RecognitionAlternate

Valore proprietà

Tipo: Microsoft.Ink.RecognitionAlternate
Oggetto RecognitionAlternate nell'insieme RecognitionAlternates a cui punta l'enumeratore.

Note

Dopo avere creato un enumeratore RecognitionAlternates.RecognitionAlternatesEnumerator o dopo avere chiamato il metodo Reset, è necessario chiamare il metodo MoveNext per spostare in avanti l'enumeratore in corrispondenza del 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 RecognitionAlternates.

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 verrà invalidato in modo irreversibile. La chiamata successiva a MoveNext o al metodo Reset genera un'eccezione InvalidOperationException. 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 questo esempio si ottiene l'oggetto System.Collections.IEnumerator per l'insieme RecognitionAlternates e lo si utilizza per attraversare l'insieme.

Dim inkRecogAlternates As List(Of String) = New List(Of String)
' get the RecognitionAlternates from the RecognitionResult object
Dim mAlternates As RecognitionAlternates = mRecognitionResult.GetAlternatesFromSelection()
' get the enumerator
Dim iEnum As RecognitionAlternates.RecognitionAlternatesEnumerator = mAlternates.GetEnumerator()
iEnum.Reset()
' traverse the collection
While iEnum.MoveNext()
    Dim theRecognitionAlternate As RecognitionAlternate = iEnum.Current
    inkRecogAlternates.Add(theRecognitionAlternate.ToString())
End While

List<String> inkRecogAlternates = new List<string>();
// get the RecognitionAlternates from the RecognitionResult object
RecognitionAlternates mAlternates = mRecognitionResult.GetAlternatesFromSelection();
// get the enumerator
RecognitionAlternates.RecognitionAlternatesEnumerator iEnum = mAlternates.GetEnumerator();
iEnum.Reset();
// traverse the collection
while (iEnum.MoveNext())
{
    RecognitionAlternate theRecognitionAlternate = iEnum.Current;
    inkRecogAlternates.Add(theRecognitionAlternate.ToString());
}

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.