String.Substring メソッド (Int32, Int32)

インスタンスから部分文字列を取得します。この部分文字列は、指定した文字位置から開始し、指定した文字数の文字列です。

Overloads Public Function Substring( _
   ByVal startIndex As Integer, _   ByVal length As Integer _) As String
[C#]
public string Substring(intstartIndex,intlength);
[C++]
public: String* Substring(intstartIndex,intlength);
[JScript]
public function Substring(
   startIndex : int,length : int) : String;

パラメータ

• startIndex
  部分文字列の開始位置のインデックス。
• length
  部分文字列の文字数。

戻り値

このインスタンスの startIndex から開始し、length の数の文字から成る文字列と等価の String 。

または

startIndex の値がこのインスタンスの長さと等しく、length が 0 の場合は Empty 。

例外

例外の種類	条件
ArgumentOutOfRangeException	startIndex と length を足した数が、このインスタンス内にない位置を示しています。 または startIndex または length が 0 未満です。

解説

startIndex が 0 から始まっています。

使用例

 
Dim myString As String = "abc"
Dim test1 As Boolean = String.Compare(myString.Substring(2, 1), "c") = 0 ' This is true.
myString.Substring(3, 1) ' This throws ArgumentOutOfRangeException.
Dim test2 As Boolean = String.Compare(myString.Substring(3, 0), String.Empty) = 0 ' This is true.

[C#] 
String myString = "abc";
bool test1 = String.Compare(myString.Substring(2, 1), "c") == 0; // This is true.
myString.Substring(3, 1); // This throws ArgumentOutOfRangeException.
bool test2 = String.Compare(myString.Substring(3, 0), String.Empty) == 0; // This is true.

[C++] 

String *myString = L"abc";
bool test1 = String::Compare(myString->Substring(2,1), L"c") == 0;  // This is true.
myString->Substring(3,1);  // This throws ArgumentOutOfRangeException.
bool test2 = String::Compare(myString->Substring(3,0), String::Empty) == 0;  // This is true.

[JScript] 
var myString : String = "abc";
var test1 : boolean = String.Compare(myString.Substring(2, 1), "c") == 0; // This is true.
myString.Substring(3, 1);  // This throws ArgumentOutOfRangeException.
var test2 : boolean = String.Compare(myString.Substring(3, 0), String.Empty) == 0; // This is true.

必要条件

プラットフォーム: 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, Common Language Infrastructure (CLI) Standard

参照

String クラス | String メンバ | System 名前空間 | String.Substring オーバーロードの一覧 | Int32 | Concat | Insert | Join | Remove | Replace | Split | Trim