StringInfo.GetNextTextElement Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

netstandard.dll, System.Runtime.dll

Ottiene il primo elemento di testo in una stringa specificata.

Overload

Nome	Descrizione
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 specificata.

GetNextTextElement(String)

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 da cui ottenere l'elemento di testo.

Valori restituiti

String

Stringa contenente il primo elemento di testo nella stringa specificata.

Eccezioni

ArgumentNullException

str è null.

Commenti

.NET definisce un elemento di testo come un'unità di testo visualizzata come un singolo carattere, ovvero un grafo. Un elemento di testo può essere un carattere di base, una coppia di surrogati o una sequenza di caratteri combinata. Lo standard Unicode definisce una coppia di surrogati come 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 elevato e la seconda è un surrogato basso. Lo standard Unicode definisce una sequenza di caratteri combinata come combinazione di un carattere di base e uno o più caratteri combinati. Una coppia di surrogati può rappresentare un carattere di base o un carattere combinato.

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

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Origine:

StringInfo.cs

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

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 da cui ottenere l'elemento di testo.

index

Int32

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

Valori restituiti

String

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

Eccezioni

ArgumentNullException

str è null.

ArgumentOutOfRangeException

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

Commenti

.NET definisce un elemento di testo come un'unità di testo visualizzata come un singolo carattere, ovvero un grafo. Un elemento di testo può essere un carattere di base, una coppia di surrogati o una sequenza di caratteri combinata. Lo standard Unicode definisce una coppia di surrogati come 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 elevato e la seconda è un surrogato basso. Lo standard Unicode definisce una sequenza di caratteri combinata come combinazione di un carattere di base e uno o più caratteri combinati. Una coppia di surrogati può rappresentare un carattere di base o un carattere combinato.

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

Vedi anche

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)