StringBuilder コンストラクター

定義

名前空間:

System.Text

アセンブリ:

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 = gcnew 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 = gcnew StringBuilder( capacity );

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設定されます。 が 0 の場合 capacity は、実装固有の既定の容量が使用されます。

こちらもご覧ください

• 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 = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );

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 = gcnew StringBuilder( capacity,maxCapacity );

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 オブジェクトはそれらを格納するために追加のメモリを割り当てます。

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

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

注意 (呼び出し元)

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

こちらもご覧ください

• 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 = 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);

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 オブジェクトはそれらを格納するために追加のメモリを割り当てます。

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

こちらもご覧ください

• 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 = 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);

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 オブジェクトはそれらを格納するために追加のメモリを割り当てます。

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

こちらもご覧ください

• Capacity