StringInfo.GetNextTextElement Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Pobiera pierwszy element tekstowy w określonym ciągu.

Przeciążenia

GetNextTextElement(String)	Pobiera pierwszy element tekstowy w określonym ciągu.
GetNextTextElement(String, Int32)	Pobiera element text w określonym indeksie określonego ciągu.

GetNextTextElement(String)

Źródło:

StringInfo.cs

Pobiera pierwszy element tekstowy w określonym ciągu.

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 być pobierany element tekstowy.

Zwraca

String

Ciąg zawierający pierwszy element tekstowy w określonym ciągu.

Wyjątki

ArgumentNullException

str to null.

Uwagi

Platforma .NET definiuje element tekstowy jako jednostkę tekstu, która jest wyświetlana jako pojedynczy znak, czyli grafem. Element tekstowy może być znakiem podstawowym, parą zastępczą lub łączącą sekwencją znaków. Standard Unicode definiuje parę zastępczą jako reprezentację znaków kodowanych dla pojedynczego abstrakcyjnego znaku, który składa się z sekwencji dwóch jednostek kodu, gdzie pierwsza jednostka pary jest wysokim zastępcą, a druga jest niskim zastępcą. Standard Unicode definiuje łączącą sekwencję znaków jako kombinację znaku podstawowego i co najmniej jeden znak łączący. Para zastępcza może reprezentować znak podstawowy lub znak łączący.

Ta metoda zwraca tylko pierwszy element tekstowy. Aby wykonać iterację po elementach tekstowych ciągu, aplikacja powinna użyć TextElementEnumerator obiektu wygenerowanego przez metodę GetTextElementEnumerator .

Zobacz też

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Źródło:

StringInfo.cs

Pobiera element text w określonym indeksie określonego ciągu.

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 być pobierany element tekstowy.

index

Int32

Indeks oparty na zerze, w którym uruchamia się element tekstowy.

Zwraca

String

Ciąg zawierający element tekstowy w określonym indeksie określonego ciągu.

Wyjątki

ArgumentNullException

str to null.

ArgumentOutOfRangeException

index znajduje się poza zakresem prawidłowych indeksów dla elementu str.

Uwagi

Platforma .NET definiuje element tekstowy jako jednostkę tekstu, która jest wyświetlana jako pojedynczy znak, czyli grafem. Element tekstowy może być znakiem podstawowym, parą zastępczą lub łączącą sekwencją znaków. Standard Unicode definiuje parę zastępczą jako reprezentację znaków kodowanych dla pojedynczego abstrakcyjnego znaku, który składa się z sekwencji dwóch jednostek kodu, gdzie pierwsza jednostka pary jest wysokim zastępcą, a druga jest niskim zastępcą. Standard Unicode definiuje łączącą sekwencję znaków jako kombinację znaku podstawowego i co najmniej jeden znak łączący. Para zastępcza może reprezentować znak podstawowy lub znak łączący.

Ta metoda zwraca tylko pierwszy element tekstowy podciągów, który rozpoczyna się od określonego indeksu. Aby wykonać iterację po elementach tekstowych ciągu, aplikacja powinna używać TextElementEnumerator wartości wygenerowanej przez metodę GetTextElementEnumerator .

Zobacz też

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)