StringBuilder 建構函式

定義

命名空間:

System.Text

組件:

netstandard.dll, System.Runtime.dll

初始化 StringBuilder 類別的新執行個體。

多載

名稱	Description
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 小於零。

範例

以下範例示範如何在指定容量下呼叫 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 為零，則使用實作特定的預設容量。

另請參閱

• 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 小於一、 capacity 小於零，或 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 為零，則使用實作特定的預設容量。

該 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 小於零。

範例

以下範例示範如何呼叫 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 為零，則使用實作特定的預設容量。

另請參閱

• 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 小於零。

-或-

startIndex plus 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 為零，則使用實作特定的預設容量。

另請參閱

• Capacity