StringInfo.GetNextTextElement 方法

定义

命名空间:

System.Globalization

程序集:

System.Runtime.dll

获取指定字符串中的第一个文本元素。

重载

GetNextTextElement(String)	获取指定字符串中的第一个文本元素。
GetNextTextElement(String, Int32)	获取指定字符串中指定索引处的文本元素。

GetNextTextElement(String)

Source:

StringInfo.cs

获取指定字符串中的第一个文本元素。

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

参数

str

String

要从中获取文本元素的字符串。

返回

String

包含指定字符串中的第一个文本元素的字符串。

例外

ArgumentNullException

str 为 null。

注解

.NET 将文本元素定义为显示为单个字符（即 grapheme）的文本单元。 文本元素可以是基字符、代理项对或组合字符序列。 Unicode Standard 将代理项对定义为单个抽象字符的编码字符表示形式，该抽象字符由两个代码单元组成的序列组成，其中对的第一个单元是高代理项，第二个是低代理项。 Unicode 标准将组合字符序列定义为基字符和一个或多个组合字符的组合。 代理项对可以表示基字符或组合字符。

此方法仅返回第一个文本元素。 若要循环访问字符串的文本元素，应用程序应使用 TextElementEnumerator 方法 GetTextElementEnumerator 生成的 对象。

另请参阅

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Source:

StringInfo.cs

获取指定字符串中指定索引处的文本元素。

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

参数

str

String

要从中获取文本元素的字符串。

index

Int32

文本元素开始位置的从零开始的索引。

返回

String

包含指定字符串中指定索引处的文本元素的字符串。

例外

ArgumentNullException

str 为 null。

ArgumentOutOfRangeException

index 超出了 str 的有效索引范围。

注解

.NET 将文本元素定义为显示为单个字符（即 grapheme）的文本单元。 文本元素可以是基字符、代理项对或组合字符序列。 Unicode Standard 将代理项对定义为单个抽象字符的编码字符表示形式，该抽象字符由两个代码单元组成的序列组成，其中对的第一个单元是高代理项，第二个是低代理项。 Unicode 标准将组合字符序列定义为基字符和一个或多个组合字符的组合。 代理项对可以表示基字符或组合字符。

此方法仅返回从指定索引开始的子字符串的第一个文本元素。 若要循环访问字符串的文本元素，应用程序应使用 TextElementEnumerator 方法 GetTextElementEnumerator 生成的 。

另请参阅

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)