StringBuilder コンストラクター

定義

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 クラスの新しいインスタンスを初期化します。

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

次の例は、パラメーターを使用せずにコンストラクターを呼び出す方法を示して StringBuilder います。

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

注釈

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

適用対象

StringBuilder(Int32)

指定した容量を使用して、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

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

例外

capacity が 0 未満です。

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

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 現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 この値は、プロパティに割り当てられ Capacity ます。 現在のインスタンスに格納される文字数がこの値を超えると、 capacity オブジェクトは、 StringBuilder 格納するために追加のメモリを割り当てます。

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

こちらもご覧ください

適用対象

StringBuilder(String)

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

public:
 StringBuilder(System::String ^ value);
public StringBuilder (string value);
public StringBuilder (string? value);
new System.Text.StringBuilder : string -> System.Text.StringBuilder
Public Sub New (value As String)

パラメーター

value
String

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

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

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 を含みます。

適用対象

StringBuilder(Int32, Int32)

指定した容量で始まり、指定した最大容量まで大きくなる 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

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

例外

maxCapacity が 1 未満か、capacity が 0 未満か、capacitymaxCapacity より大きいです。

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

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 現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 この値は、プロパティに割り当てられ 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) ます。

こちらもご覧ください

適用対象

StringBuilder(String, Int32)

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

public:
 StringBuilder(System::String ^ value, int capacity);
public StringBuilder (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

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

capacity
Int32

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

例外

capacity が 0 未満です。

次の例は、 StringBuilder 初期文字列と指定された容量を使用してコンストラクターを呼び出す方法を示しています。

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 現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 この値は、プロパティに割り当てられ Capacity ます。 現在のインスタンスに格納される文字数がこの値を超えると、 capacity オブジェクトは、 StringBuilder 格納するために追加のメモリを割り当てます。

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

こちらもご覧ください

適用対象

StringBuilder(String, Int32, Int32, Int32)

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

public:
 StringBuilder(System::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);
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

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

startIndex
Int32

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

length
Int32

部分文字列の文字数。

capacity
Int32

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

例外

capacity が 0 未満です。

  • または -

startIndexlength を加算した値が value 内の位置にありません。

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

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 現在のインスタンスによって割り当てられたメモリに格納できる最大文字数を定義します。 この値は、プロパティに割り当てられ Capacity ます。 現在のインスタンスに格納される文字数がこの値を超えると、 capacity オブジェクトは、 StringBuilder 格納するために追加のメモリを割り当てます。

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

こちらもご覧ください

適用対象