StringInfo.SubstringByTextElements StringInfo.SubstringByTextElements StringInfo.SubstringByTextElements StringInfo.SubstringByTextElements Method

定義

現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。Retrieves a substring of text elements from the current StringInfo object.

オーバーロード

SubstringByTextElements(Int32) SubstringByTextElements(Int32) SubstringByTextElements(Int32) SubstringByTextElements(Int32)

指定されたテキスト要素から最後のテキスト要素までの範囲内で、現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。Retrieves a substring of text elements from the current StringInfo object starting from a specified text element and continuing through the last text element.

SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32)

指定されたテキスト要素から指定された数のテキスト要素までの範囲内で、現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。Retrieves a substring of text elements from the current StringInfo object starting from a specified text element and continuing through the specified number of text elements.

SubstringByTextElements(Int32) SubstringByTextElements(Int32) SubstringByTextElements(Int32) SubstringByTextElements(Int32)

指定されたテキスト要素から最後のテキスト要素までの範囲内で、現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。Retrieves a substring of text elements from the current StringInfo object starting from a specified text element and continuing through the last text element.

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 Int32 Int32 Int32

この StringInfo オブジェクトのテキスト要素の 0 から始まるインデックス。The zero-based index of a text element in this StringInfo object.

戻り値

startingTextElement パラメーターで指定されたテキスト要素インデックスから、このオブジェクトの最後のテキスト要素までの範囲内にある、この StringInfo オブジェクトのテキスト要素の部分文字列。A substring of text elements in this StringInfo object, starting from the text element index specified by the startingTextElement parameter and continuing through the last text element in this object.

例外

startingTextElement が 0 未満です。startingTextElement is less than zero.

- または --or- 現在の StringInfo オブジェクトの値である文字列は、空の文字列 ("") です。The string that is the value of the current StringInfo object is the empty string ("").

注釈

0 ~ 4 のインデックスが作成された5つのテキスト要素で構成される文字列を考えてみます。Consider a string that consists of five text elements, indexed from 0 through 4. パラメーターが1の場合、メソッドSubstringByTextElementsは、インデックスが1、2、3、および4のテキスト要素で構成される部分文字列を返します。 startingTextElementIf the startingTextElement parameter is 1, the SubstringByTextElements method returns a substring that consists of the text elements for which the indexes are 1, 2, 3, and 4.

SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32) SubstringByTextElements(Int32, Int32)

指定されたテキスト要素から指定された数のテキスト要素までの範囲内で、現在の StringInfo オブジェクトからテキスト要素の部分文字列を取得します。Retrieves a substring of text elements from the current StringInfo object starting from a specified text element and continuing through the specified number of text elements.

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 Int32 Int32 Int32

この StringInfo オブジェクトのテキスト要素の 0 から始まるインデックス。The zero-based index of a text element in this StringInfo object.

lengthInTextElements
Int32 Int32 Int32 Int32

取得するテキスト要素の数。The number of text elements to retrieve.

戻り値

この StringInfo オブジェクト内のテキスト要素の部分文字列。A substring of text elements in this StringInfo object. 部分文字列は、lengthInTextElements パラメーターで指定された数のテキスト要素で構成され、startingTextElement パラメーターで指定されたテキスト要素インデックスから開始します。The substring consists of the number of text elements specified by the lengthInTextElements parameter and starts from the text element index specified by the startingTextElement parameter.

例外

startingTextElement が 0 未満です。startingTextElement is less than zero.

または-or- startingTextElement は、現在の StringInfo オブジェクトの値である文字列の長さ以上です。startingTextElement is greater than or equal to the length of the string that is the value of the current StringInfo object.

- または --or- lengthInTextElements が 0 未満です。lengthInTextElements is less than zero.

- または --or- 現在の StringInfo オブジェクトの値である文字列は、空の文字列 ("") です。The string that is the value of the current StringInfo object is the empty string ("").

または-or- startingTextElement + lengthInTextElements は、この StringInfo オブジェクト内のテキスト要素の数より大きいインデックスを指定します。startingTextElement + lengthInTextElements specify an index that is greater than the number of text elements in this StringInfo object.

注釈

0 ~ 4 のインデックスが作成された5つのテキスト要素で構成される文字列を考えてみます。Consider a string that consists of five text elements, indexed from 0 through 4. パラメーターが 1 lengthInTextElementsで、パラメーターが3の場合、メソッドSubstringByTextElementsは、インデックスが1、2、および3であるテキスト要素で構成される部分文字列を返します。 startingTextElementIf the startingTextElement parameter is 1 and the lengthInTextElements parameter is 3, the SubstringByTextElements method returns a substring that consists of the text elements for which the indexes are 1, 2, and 3.

適用対象