StringInfo.GetNextTextElement メソッド

定義

名前空間:

System.Globalization

アセンブリ:

System.Runtime.dll

指定した文字列の最初のテキスト要素を取得します。

オーバーロード

GetNextTextElement(String)	指定した文字列の最初のテキスト要素を取得します。
GetNextTextElement(String, Int32)	指定した文字列の指定したインデックスにあるテキスト要素を取得します。

GetNextTextElement(String)

ソース:

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 では、1 つの文字 (つまり、グラフ) として表示されるテキストの単位としてテキスト要素を定義します。 テキスト要素には、基本文字、サロゲート ペア、または結合文字シーケンスを指定できます。 Unicode 標準では、2 つのコード単位のシーケンスで構成される 1 つの抽象文字のコード化された文字表現としてサロゲート ペアが定義されています。このペアの最初の単位は上位サロゲートで、2 つ目は低サロゲートです。 Unicode 標準では、基本文字と 1 つ以上の組み合わせ文字の組み合わせとして、結合文字シーケンスが定義されています。 サロゲート ペアは、基本文字または結合文字を表すことができます。

このメソッドは、最初のテキスト要素のみを返します。 文字列のテキスト要素を反復処理するには、 メソッドによって生成された オブジェクトを TextElementEnumerator アプリケーションで使用する GetTextElementEnumerator 必要があります。

こちらもご覧ください

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

ソース:

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

テキスト要素が開始する位置の、0 から始まるインデックス番号。

戻り値

String

指定した文字列の指定したインデックスにあるテキスト要素を格納している文字列。

例外

ArgumentNullException

str が nullです。

ArgumentOutOfRangeException

index は str の有効なインデックスの範囲外です。

注釈

.NET では、1 つの文字 (つまり、グラフ) として表示されるテキストの単位としてテキスト要素を定義します。 テキスト要素には、基本文字、サロゲート ペア、または結合文字シーケンスを指定できます。 Unicode 標準では、2 つのコード単位のシーケンスで構成される 1 つの抽象文字のコード化された文字表現としてサロゲート ペアが定義されています。このペアの最初の単位は上位サロゲートで、2 つ目は低サロゲートです。 Unicode 標準では、基本文字と 1 つ以上の組み合わせ文字の組み合わせとして、結合文字シーケンスが定義されています。 サロゲート ペアは、基本文字または結合文字を表すことができます。

このメソッドは、指定したインデックスから始まる部分文字列の最初のテキスト要素のみを返します。 文字列のテキスト要素を反復処理するには、 メソッドによって生成された を TextElementEnumerator アプリケーションで使用する GetTextElementEnumerator 必要があります。

こちらもご覧ください

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)