StringBuilder StringBuilder StringBuilder StringBuilder Constructors

定義

オーバーロード

StringBuilder() StringBuilder() StringBuilder()

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

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

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

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

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

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

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

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

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

StringBuilder() StringBuilder() 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(Int32) StringBuilder(Int32) 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 Int32 Int32 Int32

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

例外

次の例は、指定され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 0 の場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

StringBuilder(String) StringBuilder(String) StringBuilder(String) 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 String String 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(Int32, Int32) StringBuilder(Int32, Int32) 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 Int32 Int32 Int32

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

maxCapacity
Int32 Int32 Int32 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 0 の場合は、実装固有の既定の容量が使用されます。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. 現在のインスタンスに格納される文字数がこのmaxCapacityStringBuilderを超える場合、オブジェクトは追加のメモリを割り当てませんが、代わりに例外をスローします。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バージョンでは、 StringBuilder(Int32, Int32)コンストラクターを呼び出すことによってオブジェクトをインスタンス化するときに、 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(String, Int32) StringBuilder(String, Int32) 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 String String 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 Int32 Int32 Int32

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

例外

次の例は、初期文字列と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 0 の場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) 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 String String 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 Int32 Int32 Int32

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

length
Int32 Int32 Int32 Int32

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

capacity
Int32 Int32 Int32 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 0 の場合は、実装固有の既定の容量が使用されます。If capacity is zero, the implementation-specific default capacity is used.

こちらもご覧ください

適用対象