StringInfo.GetNextTextElement Metoda

Definicja

Pobiera pierwszy element tekstowy w określonym ciągu.Gets the first text element in a specified string.

Przeciążenia

GetNextTextElement(String)

Pobiera pierwszy element tekstowy w określonym ciągu.Gets the first text element in a specified string.

GetNextTextElement(String, Int32)

Pobiera element tekstowy przy określonym indeksie określonego ciągu.Gets the text element at the specified index of the specified string.

GetNextTextElement(String)

Pobiera pierwszy element tekstowy w określonym ciągu.Gets the first text element in a specified string.

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

Parametry

str
String

Ciąg, z którego ma zostać pobrany element tekstowy.The string from which to get the text element.

Zwraca

String

Ciąg zawierający pierwszy element tekstowy w określonym ciągu.A string containing the first text element in the specified string.

Wyjątki

str to null.str is null.

Uwagi

Platforma .NET definiuje element tekstowy jako jednostkę tekstu wyświetlaną jako pojedynczy znak, czyli Grapheme..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Element tekstowy może być znakiem podstawowym, parą zastępczą lub kombinacją sekwencji znaków.A text element can be a base character, a surrogate pair, or a combining character sequence. Standard Unicode definiuje parę zastępczą jako reprezentację kodowanego znaku dla pojedynczego znaku abstrakcyjnego, który składa się z sekwencji dwóch jednostek kodu, gdzie pierwsza jednostka pary jest górnym surogatem, a drugi jest dolnym surogatem.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. Standard Unicode definiuje Łączenie sekwencji znaków jako kombinację znaku podstawowego i jednego lub więcej łączących się znaków.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Para dwuskładnikowa może reprezentować znak podstawowy lub łączący znak.A surrogate pair can represent a base character or a combining character.

Ta metoda zwraca tylko pierwszy element tekstu.This method only returns the first text element. Aby wykonać iterację elementów tekstowych ciągu, aplikacja powinna używać TextElementEnumerator obiektu wygenerowanego przez GetTextElementEnumerator metodę.To iterate through the text elements of the string, the application should use the TextElementEnumerator object generated by the GetTextElementEnumerator method.

Zobacz też

Dotyczy

Produkt Wprowadzono

GetNextTextElement(String, Int32)

Pobiera element tekstowy przy określonym indeksie określonego ciągu.Gets the text element at the specified index of the specified string.

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

Parametry

str
String

Ciąg, z którego ma zostać pobrany element tekstowy.The string from which to get the text element.

index
Int32

Indeks (liczony od zera), w którym jest uruchamiany element Text.The zero-based index at which the text element starts.

Zwraca

String

Ciąg zawierający element tekstowy w określonym indeksie określonego ciągu.A string containing the text element at the specified index of the specified string.

Wyjątki

str to null.str is null.

index znajduje się poza zakresem prawidłowych indeksów dla str .index is outside the range of valid indexes for str.

Uwagi

Platforma .NET definiuje element tekstowy jako jednostkę tekstu wyświetlaną jako pojedynczy znak, czyli Grapheme..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Element tekstowy może być znakiem podstawowym, parą zastępczą lub kombinacją sekwencji znaków.A text element can be a base character, a surrogate pair, or a combining character sequence. Standard Unicode definiuje parę zastępczą jako reprezentację kodowanego znaku dla pojedynczego znaku abstrakcyjnego, który składa się z sekwencji dwóch jednostek kodu, gdzie pierwsza jednostka pary jest górnym surogatem, a drugi jest dolnym surogatem.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. Standard Unicode definiuje Łączenie sekwencji znaków jako kombinację znaku podstawowego i jednego lub więcej łączących się znaków.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Para dwuskładnikowa może reprezentować znak podstawowy lub łączący znak.A surrogate pair can represent a base character or a combining character.

Ta metoda zwraca tylko pierwszy element tekstowy podciągu, który zaczyna się od określonego indeksu.This method only returns the first text element of the substring that starts at the specified index. Aby wykonać iterację elementów tekstowych ciągu, aplikacja powinna używać TextElementEnumerator wygenerowanej przez GetTextElementEnumerator metodę.To iterate through the text elements of the string, the application should use the TextElementEnumerator generated by the GetTextElementEnumerator method.

Zobacz też

Dotyczy

Produkt Wprowadzono