Condividi tramite


StringInfo.GetNextTextElement Metodo

Definizione

Ottiene il primo elemento di testo in una stringa specificata.

Overload

GetNextTextElement(String)

Ottiene il primo elemento di testo in una stringa specificata.

GetNextTextElement(String, Int32)

Ottiene l'elemento di testo in corrispondenza dell'indice specificato della stringa indicata.

GetNextTextElement(String)

Origine:
StringInfo.cs
Origine:
StringInfo.cs
Origine:
StringInfo.cs

Ottiene il primo elemento di testo in una stringa specificata.

public:
 static System::String ^ GetNextTextElement(System::String ^ str);
public static string GetNextTextElement (string str);
static member GetNextTextElement : string -> string
Public Shared Function GetNextTextElement (str As String) As String

Parametri

str
String

Stringa dalla quale ottenere l'elemento di testo.

Restituisce

Stringa contenente il primo elemento di testo nella stringa specificata.

Eccezioni

str è null.

Commenti

.NET definisce un elemento di testo come unità di testo visualizzato come singolo carattere, ovvero un grapheme. Un elemento di testo può essere un carattere di base, una coppia surrogata o una sequenza di caratteri combinata. Unicode Standard definisce una coppia surrogata come rappresentazione di caratteri codificati per un singolo carattere astratto costituito da una sequenza di due unità di codice, dove la prima unità della coppia è un surrogato elevato e la seconda è un surrogato basso. Unicode Standard definisce una sequenza di caratteri combinata come combinazione di un carattere di base e uno o più caratteri di combinazione. Una coppia surrogata può rappresentare un carattere di base o un carattere di combinazione.

Questo metodo restituisce solo il primo elemento di testo. Per scorrere gli elementi di testo della stringa, l'applicazione deve usare l'oggetto TextElementEnumerator generato dal GetTextElementEnumerator metodo .

Vedi anche

Si applica a

GetNextTextElement(String, Int32)

Origine:
StringInfo.cs
Origine:
StringInfo.cs
Origine:
StringInfo.cs

Ottiene l'elemento di testo in corrispondenza dell'indice specificato della stringa indicata.

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);
public static string GetNextTextElement (string str, int index);
static member GetNextTextElement : string * int -> string
Public Shared Function GetNextTextElement (str As String, index As Integer) As String

Parametri

str
String

Stringa dalla quale ottenere l'elemento di testo.

index
Int32

Indice in base zero in corrispondenza del quale inizia l'elemento di testo.

Restituisce

Stringa contenente l'elemento di testo in corrispondenza dell'indice specificato della stringa indicata.

Eccezioni

str è null.

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

Commenti

.NET definisce un elemento di testo come unità di testo visualizzato come singolo carattere, ovvero un grapheme. Un elemento di testo può essere un carattere di base, una coppia surrogata o una sequenza di caratteri combinata. Unicode Standard definisce una coppia surrogata come rappresentazione di caratteri codificati per un singolo carattere astratto costituito da una sequenza di due unità di codice, dove la prima unità della coppia è un surrogato elevato e la seconda è un surrogato basso. Unicode Standard definisce una sequenza di caratteri combinata come combinazione di un carattere di base e uno o più caratteri di combinazione. Una coppia surrogata può rappresentare un carattere di base o un carattere di combinazione.

Questo metodo restituisce solo il primo elemento di testo della sottostringa che inizia all'indice specificato. Per scorrere gli elementi di testo della stringa, l'applicazione deve usare il TextElementEnumerator metodo generato dal GetTextElementEnumerator metodo .

Vedi anche

Si applica a