StringInfo.SubstringByTextElements メソッド

定義

現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。

オーバーロード

名前 説明
SubstringByTextElements(Int32)

現在の StringInfo オブジェクトから、指定したテキスト要素から始まり、最後のテキスト要素まで続くテキスト要素の部分文字列を取得します。

SubstringByTextElements(Int32, Int32)

指定したテキスト要素から開始し、指定した数のテキスト要素を続けて現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。

SubstringByTextElements(Int32)

現在の StringInfo オブジェクトから、指定したテキスト要素から始まり、最後のテキスト要素まで続くテキスト要素の部分文字列を取得します。

public:
 System::String ^ SubstringByTextElements(int startingTextElement);
public string SubstringByTextElements(int startingTextElement);
member this.SubstringByTextElements : int -> string
Public Function SubstringByTextElements (startingTextElement As Integer) As String

パラメーター

startingTextElement
Int32

この StringInfo オブジェクト内のテキスト要素の 0 から始まるインデックス。

返品

この StringInfo オブジェクト内のテキスト要素の部分文字列。 startingTextElement パラメーターで指定されたテキスト要素インデックスから始まり、このオブジェクトの最後のテキスト要素を続行します。

例外

startingTextElement が 0 未満です。

-または-

現在の StringInfo オブジェクトの値である文字列は、空の文字列 ("") です。

注釈

0 から 4 のインデックスが付いた 5 つのテキスト要素で構成される文字列を考えてみましょう。 startingTextElement パラメーターが 1 の場合、SubstringByTextElements メソッドは、インデックスが 1、2、3、4 であるテキスト要素で構成される部分文字列を返します。

適用対象

SubstringByTextElements(Int32, Int32)

指定したテキスト要素から開始し、指定した数のテキスト要素を続けて現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。

public:
 System::String ^ SubstringByTextElements(int startingTextElement, int lengthInTextElements);
public string SubstringByTextElements(int startingTextElement, int lengthInTextElements);
member this.SubstringByTextElements : int * int -> string
Public Function SubstringByTextElements (startingTextElement As Integer, lengthInTextElements As Integer) As String

パラメーター

startingTextElement
Int32

この StringInfo オブジェクト内のテキスト要素の 0 から始まるインデックス。

lengthInTextElements
Int32

取得するテキスト要素の数。

返品

この StringInfo オブジェクト内のテキスト要素の部分文字列。 部分文字列は、 lengthInTextElements パラメーターで指定されたテキスト要素の数で構成され、 startingTextElement パラメーターで指定されたテキスト要素インデックスから開始されます。

例外

startingTextElement が 0 未満です。

-または-

startingTextElement は、現在の StringInfo オブジェクトの値である文字列の長さ以上です。

-または-

lengthInTextElements が 0 未満です。

-または-

現在の StringInfo オブジェクトの値である文字列は、空の文字列 ("") です。

-または-

startingTextElement + lengthInTextElements この StringInfo オブジェクト内のテキスト要素の数より大きいインデックスを指定します。

注釈

0 から 4 のインデックスが付いた 5 つのテキスト要素で構成される文字列を考えてみましょう。 startingTextElement パラメーターが 1 で、lengthInTextElements パラメーターが 3 の場合、SubstringByTextElements メソッドは、インデックスが 1、2、3 であるテキスト要素で構成される部分文字列を返します。

適用対象