StringBuilder コンストラクタ (String, Int32, Int32, Int32)

指定した部分文字列および容量から StringBuilder クラスの新しいインスタンスを初期化します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)

構文

'宣言
Public Sub New ( _
    value As String, _
    startIndex As Integer, _
    length As Integer, _
    capacity As Integer _
)
'使用
Dim value As String
Dim startIndex As Integer
Dim length As Integer
Dim capacity As Integer

Dim instance As New StringBuilder(value, startIndex, length, capacity)

public StringBuilder (
    string value,
    int startIndex,
    int length,
    int capacity
)

public:
StringBuilder (
    String^ value, 
    int startIndex, 
    int length, 
    int capacity
)

public StringBuilder (
    String value, 
    int startIndex, 
    int length, 
    int capacity
)

public function StringBuilder (
    value : String, 
    startIndex : int, 
    length : int, 
    capacity : int
)

適用できません。

パラメータ

• value
  このインスタンスの値を初期化するために使用される部分文字列を含む文字列。value が null 参照 (Visual Basic では Nothing) の場合、新しい StringBuilder は空の文字列、つまり、Empty を含みます。

• startIndex
  value における部分文字列の開始位置。

• length
  部分文字列の文字数。

• capacity
  StringBuilder の推奨される開始サイズ。

例外

例外の種類	条件
ArgumentOutOfRangeException	capacity が 0 未満です。 または startIndex に length を加算した値が、value 内にない位置を示しています。

解説

capacity が 0 の場合は、実装に固有な既定容量が使用されます。

使用例

次のコード例は、文字列を指定して StringBuilder コンストラクタを呼び出す方法を示しています。

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

String^ initialString = L"Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,startIndex,substringLength,capacity );

String initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString,
    startIndex, substringLength, capacity);

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

.NET Compact Framework

サポート対象 : 2.0,1.0

XNA Framework

サポート対象 : 1.0

参照

関連項目

StringBuilder クラス
StringBuilder メンバ
System.Text 名前空間