StringBuilder コンストラクター

定義

名前空間:

System.Text

アセンブリ:

netstandard.dll, System.Runtime.dll

StringBuilder クラスの新しいインスタンスを初期化します。

オーバーロード

名前	説明
StringBuilder()	StringBuilder クラスの新しいインスタンスを初期化します。
StringBuilder(Int32)	指定した容量を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。
StringBuilder(String)	指定した文字列を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。
StringBuilder(Int32, Int32)	指定した容量で始まり、指定した最大値まで拡張できる、 StringBuilder クラスの新しいインスタンスを初期化します。
StringBuilder(String, Int32)	指定した文字列と容量を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。
StringBuilder(String, Int32, Int32, Int32)	指定した部分文字列と容量から、 StringBuilder クラスの新しいインスタンスを初期化します。

StringBuilder()

ソース:

StringBuilder.cs

StringBuilder クラスの新しいインスタンスを初期化します。

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

例

次の例では、パラメーターなしで StringBuilder コンストラクターを呼び出す方法を示します。

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

注釈

このインスタンスの文字列値は String.Empty に設定され、容量は実装固有の既定の容量に設定されます。

StringBuilder(Int32)

ソース:

StringBuilder.cs

指定した容量を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

パラメーター

capacity

Int32

このインスタンスの推奨される開始サイズ。

例外

ArgumentOutOfRangeException

capacity が 0 未満です。

例

次の例では、指定した容量で StringBuilder コンストラクターを呼び出す方法を示します。

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 その値は、 Capacity プロパティに割り当てられます。 現在のインスタンスに格納する文字数がこの capacity 値を超えた場合、 StringBuilder オブジェクトは、格納する追加のメモリを割り当てます。

このインスタンスの文字列値は、 String.Emptyに設定されます。 capacityが 0 の場合、実装固有の既定の容量が使用されます。

こちらもご覧ください

• Capacity

StringBuilder(String)

ソース:

StringBuilder.cs

指定した文字列を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。

public:
 StringBuilder(System::String ^ value);

public StringBuilder(string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

パラメーター

value

String

インスタンスの値を初期化するために使用される文字列。 valueがnullされている場合、新しいStringBuilderには空の文字列 (つまり、Emptyが含まれます) が含まれます。

例

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

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

注釈

valueがnullされている場合、新しいStringBuilderには空の文字列 (つまり、Emptyが含まれます) が含まれます。

StringBuilder(Int32, Int32)

ソース:

StringBuilder.cs

指定した容量で始まり、指定した最大値まで拡張できる、 StringBuilder クラスの新しいインスタンスを初期化します。

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder(int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

パラメーター

capacity

Int32

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

maxCapacity

Int32

現在の文字列に含めることができる最大文字数。

例外

ArgumentOutOfRangeException

maxCapacity が 1 未満、 capacity が 0 未満、または capacity が maxCapacity より大きい。

例

次の例では、指定した容量と最大容量で StringBuilder コンストラクターを呼び出す方法を示します。

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 その値は、 Capacity プロパティに割り当てられます。 現在のインスタンスに格納する文字数がこの capacity 値を超えた場合、 StringBuilder オブジェクトは、格納する追加のメモリを割り当てます。

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

maxCapacity プロパティは、現在のインスタンスが保持できる最大文字数を定義します。 その値は、 MaxCapacity プロパティに割り当てられます。 現在のインスタンスに格納する文字数がこの maxCapacity 値を超えた場合、 StringBuilder オブジェクトは追加のメモリを割り当てず、代わりに例外をスローします。

注意 (呼び出し元)

.NET Core および .NET Framework 4.0 以降のバージョンでは、StringBuilder コンストラクターを呼び出してStringBuilder(Int32, Int32) オブジェクトをインスタンス化すると、StringBuilder インスタンスの長さと容量の両方が、MaxCapacity プロパティの値を超えて拡張される可能性があります。 これは特に、 Append(String) メソッドと AppendFormat(String, Object) メソッドを呼び出して小さな文字列を追加するときに発生する可能性があります。

こちらもご覧ください

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

ソース:

StringBuilder.cs

指定した文字列と容量を使用して、 StringBuilder クラスの新しいインスタンスを初期化します。

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder(string? value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

パラメーター

value

String

インスタンスの値を初期化するために使用される文字列。 valueがnullされている場合、新しいStringBuilderには空の文字列 (つまり、Emptyが含まれます) が含まれます。

capacity

Int32

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

例外

ArgumentOutOfRangeException

capacity が 0 未満です。

例

次の例では、最初の文字列と指定した容量で StringBuilder コンストラクターを呼び出す方法を示します。

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 その値は、 Capacity プロパティに割り当てられます。 現在のインスタンスに格納する文字数がこの capacity 値を超えた場合、 StringBuilder オブジェクトは、格納する追加のメモリを割り当てます。

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

こちらもご覧ください

• Capacity

StringBuilder(String, Int32, Int32, Int32)

ソース:

StringBuilder.cs

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

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

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

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

パラメーター

value

String

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

startIndex

Int32

部分文字列の開始位置 value 内の位置。

length

Int32

部分文字列内の文字数。

capacity

Int32

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

例外

ArgumentOutOfRangeException

capacity が 0 未満です。

-又は-

startIndex プラス length は value内の位置ではありません。

例

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

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

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

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)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 その値は、 Capacity プロパティに割り当てられます。 現在のインスタンスに格納する文字数がこの capacity 値を超えた場合、 StringBuilder オブジェクトは、格納する追加のメモリを割り当てます。

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

こちらもご覧ください

• Capacity