次の方法で共有


StringInfo.GetNextTextElement メソッド (String, Int32)

指定した文字列の指定したインデックスにあるテキスト要素を取得します。

Overloads Public Shared Function GetNextTextElement( _
   ByVal str As String, _   ByVal index As Integer _) As String
[C#]
public static string GetNextTextElement(stringstr,intindex);
[C++]
public: static String* GetNextTextElement(String* str,intindex);
[JScript]
public static function GetNextTextElement(
   str : String,index : int) : String;

パラメータ

  • str
    テキスト要素の取得元の文字列。
  • index
    テキスト要素が開始する位置の、0 から始まるインデックス番号。

戻り値

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

例外

例外の種類 条件
ArgumentNullException str が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException index が str の有効なインデックスの範囲外の値です。

解説

.NET Framework は、単一の文字として表示されるテキストの単位、つまり書記素としてテキスト要素を定義します。テキスト要素は、基本文字、サロゲート ペア、または組み合わせた文字シーケンスの場合があります。Unicode Standard は、サロゲート ペアを 2 つのコード単位から成る単一の抽象文字を表すコード化文字表現として定義します。ペアの最初の単位が上位サロゲート、2 番目の単位が下位サロゲートとなります。Unicode Standard は、組み合わせ文字シーケンスを 1 つの基本文字と 1 つ以上の組み合わせ文字の組み合わせとして定義します。サロゲート ペアは、基本文字または組み合わせた文字を表すことができます。サロゲート ペアおよび組み合わせ文字シーケンスの詳細については、http://www.unicode.org の「The Unicode Standard」を参照してください。

このメソッドは、指定したインデックスから開始する部分文字列の最初のテキスト要素だけを返します。文字列のテキスト要素を反復処理するには、 GetTextElementEnumerator メソッドが生成する TextElementEnumerator を使用します。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

StringInfo クラス | StringInfo メンバ | System.Globalization 名前空間 | StringInfo.GetNextTextElement オーバーロードの一覧 | GetTextElementEnumerator | ParseCombiningCharacters