StringBuilder コンストラクター

定義

StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class.

オーバーロード

StringBuilder()

StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class.

StringBuilder(Int32)

指定した容量を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String)

指定した文字列を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32)

指定した容量で始まり、指定した最大容量まで大きくなる StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32)

指定した文字列および容量を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32)

指定した部分文字列および容量から StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder()

StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class.

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

次の例は、パラメーターを使用せずに StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with no parameters.

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
Dim stringBuilder As New StringBuilder

注釈

このインスタンスの文字列値は String.Emptyに設定され、容量は実装固有の既定の容量に設定されます。The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32)

指定した容量を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

パラメーター

capacity
Int32

このインスタンスの推奨される開始サイズ。The suggested starting size of this instance.

例外

capacity に 0 より小さい値が指定されています。capacity is less than zero.

次の例は、指定された容量で StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. この値は Capacity プロパティに割り当てられます。Its value is assigned to the Capacity property. 現在のインスタンスに格納されている文字数がこの capacity 値を超える場合、StringBuilder オブジェクトは、それを格納するために追加のメモリを割り当てます。If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

このインスタンスの文字列値が String.Emptyに設定されています。The string value of this instance is set to String.Empty. capacity がゼロの場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

StringBuilder(String)

指定した文字列を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified string.

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

インスタンスの値を初期化するために使用される文字列。The string used to initialize the value of the instance. valuenull の場合、新しい StringBuilder は空の文字列、つまり、Empty を含みます。If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

次の例は、指定された文字列を使用して StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

注釈

valuenull の場合、新しい StringBuilder は空の文字列、つまり、Empty を含みます。If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32)

指定した容量で始まり、指定した最大容量まで大きくなる StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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 の推奨される開始サイズ。The suggested starting size of the StringBuilder.

maxCapacity
Int32

現在の文字列が含むことができる最大文字数。The maximum number of characters the current string can contain.

例外

maxCapacity が 1 未満か、capacity が 0 未満か、capacitymaxCapacity より大きいです。maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

次の例は、指定された容量と最大容量を使用して StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. この値は Capacity プロパティに割り当てられます。Its value is assigned to the Capacity property. 現在のインスタンスに格納されている文字数がこの capacity 値を超える場合、StringBuilder オブジェクトは、それを格納するために追加のメモリを割り当てます。If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

capacity がゼロの場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

maxCapacity プロパティは、現在のインスタンスが保持できる最大文字数を定義します。The maxCapacity property defines the maximum number of characters that the current instance can hold. この値は MaxCapacity プロパティに割り当てられます。Its value is assigned to the MaxCapacity property. 現在のインスタンスに格納される文字数がこの maxCapacity 値を超える場合、StringBuilder オブジェクトは追加のメモリを割り当てませんが、代わりに例外がスローされます。If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

注意 (呼び出し元)

.NET Core および .NET Framework 4.0 以降のバージョンでは、StringBuilder(Int32, Int32) コンストラクターを呼び出すことによって StringBuilder オブジェクトをインスタンス化すると、StringBuilder インスタンスの長さと容量の両方が、その MaxCapacity プロパティの値を超えて拡張される可能性があります。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. これは、Append(String)AppendFormat(String, Object) メソッドを呼び出して小さい文字列を追加する場合に特に発生します。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

StringBuilder(String, Int32)

指定した文字列および容量を使用して、StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class using the specified string and capacity.

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

インスタンスの値を初期化するために使用される文字列。The string used to initialize the value of the instance. valuenull の場合、新しい StringBuilder は空の文字列、つまり、Empty を含みます。If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32

StringBuilder の推奨される開始サイズ。The suggested starting size of the StringBuilder.

例外

capacity に 0 より小さい値が指定されています。capacity is less than zero.

次の例は、初期文字列と指定された容量を使用して StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

String^ initialString = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );
string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

注釈

capacity パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. この値は Capacity プロパティに割り当てられます。Its value is assigned to the Capacity property. 現在のインスタンスに格納されている文字数がこの capacity 値を超える場合、StringBuilder オブジェクトは、それを格納するために追加のメモリを割り当てます。If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

capacity がゼロの場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

StringBuilder(String, Int32, Int32, Int32)

指定した部分文字列および容量から StringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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

このインスタンスの値を初期化するために使用される部分文字列を含む文字列。The string that contains the substring used to initialize the value of this instance. valuenull の場合、新しい StringBuilder は空の文字列、つまり、Empty を含みます。If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32

value における部分文字列の開始位置。The position within value where the substring begins.

length
Int32

substring の文字数。The number of characters in the substring.

capacity
Int32

StringBuilder の推奨される開始サイズ。The suggested starting size of the StringBuilder.

例外

capacity に 0 より小さい値が指定されています。capacity is less than zero.

または-or-

startIndexlength を加算した値が value 内の位置にありません。startIndex plus length is not a position within value.

次の例は、指定された文字列を使用して StringBuilder コンストラクターを呼び出す方法を示しています。The following example demonstrates how to call the StringBuilder constructor with the specified string.

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);
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 パラメーターは、現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. この値は Capacity プロパティに割り当てられます。Its value is assigned to the Capacity property. 現在のインスタンスに格納されている文字数がこの capacity 値を超える場合、StringBuilder オブジェクトは、それを格納するために追加のメモリを割り当てます。If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

capacity がゼロの場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

適用対象