Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo StringInfo.GetTextElementEnumerator (String, Int32)

 

Data di pubblicazione: ottobre 2016

Restituisce un enumeratore che scorre gli elementi di testo della stringa, a partire dall'indice specificato.

Spazio dei nomi:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

public static TextElementEnumerator GetTextElementEnumerator(
	string str,
	int index
)

Parametri

str
Type: System.String

Stringa da scorrere.

index
Type: System.Int32

Indice in base zero in corrispondenza del quale avviare l'iterazione.

Valore restituito

Type: System.Globalization.TextElementEnumerator

Oggetto TextElementEnumerator per la stringa a partire da index.

Exception Condition
ArgumentNullException

str è null.

ArgumentOutOfRangeException

index non è compreso nell'intervallo di indici validi per str.

.NET Framework definisce un elemento di testo come un'unità di testo che viene visualizzato come un singolo carattere, vale a dire un grafemi. Un elemento di testo può essere un carattere di base, una coppia di surrogati o un carattere di combinazione sequenza. Il Unicode Standard definisce una coppia di surrogati come una rappresentazione di caratteri codificati per un singolo carattere astratto costituito da una sequenza di due unità di codice, in cui la prima unità della coppia è un surrogato alto e il secondo è un surrogato basso. Lo Unicode Standard definisce una combinazione sequenza come una combinazione di un carattere di base e uno o più caratteri di combinazione di caratteri. Una coppia di surrogati può rappresentare un carattere di base o un carattere di combinazione.

L'enumeratore di elemento di testo viene utilizzato solo per leggere i dati nella stringa. è possibile modificare la stringa sottostante. L'enumeratore non dispone di accesso esclusivo alla stringa.

Se è posizionato prima del primo elemento di testo nella stringa o dopo l'ultimo elemento nella stringa di testo, l'enumeratore è in uno stato non valido. Se l'enumeratore si trova in uno stato non valido, la chiamata Current genera un'eccezione.

Inizialmente, l'enumeratore è posizionato prima del primo elemento di testo nella stringa. Anche il metodo Reset riporta l'enumeratore in questa posizione. Di conseguenza, dopo la creazione di un enumeratore o dopo Reset viene chiamato, MoveNext deve essere chiamato per passare l'enumeratore al primo elemento di testo della stringa prima di leggere il valore di Current.

Current restituisce lo stesso oggetto finché non viene chiamato il metodo MoveNext o Reset.

Una volta raggiunta la fine della stringa, l'enumeratore è nuovamente in un stato non valido e chiamato MoveNext restituisce false. La chiamata Current genera un'eccezione se l'ultima chiamata a MoveNext restituito false.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: