RecognitionAlternates.RecognitionAlternatesEnumerator.Current-Eigenschaft
Ruft das RecognitionAlternate-Objekt in der RecognitionAlternates-Auflistung ab, auf das der Enumerator zeigt.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public ReadOnly Property Current As RecognitionAlternate
'Usage
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
Eigenschaftenwert
Typ: Microsoft.Ink.RecognitionAlternate
Das RecognitionAlternate-Objekt in der RecognitionAlternates-Auflistung, auf das der Enumerator zeigt.
Hinweise
Nach dem Erstellen eines RecognitionAlternates.RecognitionAlternatesEnumerator-Enumerators oder nach dem Aufrufen der Reset-Methode muss die MoveNext-Methode aufgerufen werden, um den Enumerator vor dem Lesen des Werts der Current-Eigenschaft auf das erste Element der Auflistung festzulegen. Andernfalls ist die Current-Eigenschaft nicht definiert.
Die Current-Eigenschaft löst eine Ausnahme aus, wenn der letzte Aufruf der MoveNext-Methode false zurückgibt. Wenn der letzte Aufruf der MoveNext-Methode den Wert false zurückgibt, hat der Enumerator das Ende der RecognitionAlternates-Auflistung erreicht.
Die Current-Eigenschaft verschiebt nicht die Position des Enumerators. Nachfolgende Aufrufe der Current-Eigenschaft geben dasselbe Objekt zurück, bis entweder die MoveNext-Methode oder die Reset-Methode aufgerufen wird.
Ein Enumerator bleibt so lange gültig, bis die Auflistung geändert wird. Wenn an der Auflistung Änderungen vorgenommen werden, z. B. durch Hinzufügen, Ändern oder Löschen von Elementen, wird der Enumerator unwiderruflich ungültig. Der nächste Aufruf der MoveNext-Methode oder der Reset-Methode löst eine InvalidOperationException-Ausnahme aus. Wenn die Auflistung zwischen dem Aufruf der MoveNext-Methode und dem Aufruf der Current-Eigenschaft geändert wird, gibt die Current-Eigenschaft das Element zurück, auf das sie festgelegt wurde, auch wenn der Enumerator bereits ungültig ist.
Beispiele
In diesem Beispiel wird der System.Collections.IEnumerator für die RecognitionAlternates-Auflistung abgerufen und zum Durchlaufen der Auflistung verwendet.
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());
}
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0
Siehe auch
Referenz
RecognitionAlternates.RecognitionAlternatesEnumerator-Klasse
RecognitionAlternates.RecognitionAlternatesEnumerator-Member
RecognitionAlternates.RecognitionAlternatesEnumerator.MoveNext
RecognitionAlternates.RecognitionAlternatesEnumerator.Reset