StringBuilder 建構函式

參考

定義

命名空間:: System.Text

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 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.cs

來源:: 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.cs

來源:: 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 = 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 。如果 capacity 為零，則會使用實作特定的預設容量。

另請參閱

Capacity

適用於

StringBuilder(String)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

以指定的字串初始化 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

用來初始化執行個體值的字串。如果 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.cs

來源:: 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 = 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 為零，則會使用實作特定的預設容量。

屬性 maxCapacity 會定義目前實例可以保留的最大字元數。其值會指派給 MaxCapacity 屬性。如果要儲存在目前實例中的字元數超過此值 maxCapacity ， StringBuilder 物件不會配置額外的記憶體，而是會擲回例外狀況。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中，當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時，實例的 StringBuilder 長度和容量都可以成長超過其 MaxCapacity 屬性的值。當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時，就會發生此情況。

另請參閱

適用於

StringBuilder(String, Int32)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

使用指定的字串和容量，來初始化 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

用來初始化執行個體值的字串。如果 value 為 null，新的 StringBuilder 將包含空字串 (即包含 Empty)。

capacity: Int32

StringBuilder 建議的起始大小。

例外狀況

ArgumentOutOfRangeException

capacity 小於零。

範例

下列範例示範如何使用初始字串和指定的容量來呼叫 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

適用於

StringBuilder(String, Int32, Int32, Int32)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

以指定的子字串和容量初始化 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

字串，包含用來初始化此執行個體值的子字串。如果 value 為 null，新的 StringBuilder 將包含空字串 (即包含 Empty)。

startIndex: Int32

在 value 內子字串開始的位置。

length: Int32

子字串中的字元數。

capacity: Int32

StringBuilder 建議的起始大小。

例外狀況

ArgumentOutOfRangeException

capacity 小於零。

-或-

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

適用於

共用方式為

StringBuilder 建構函式

定義

多載

StringBuilder()

範例

備註

適用於

StringBuilder(Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

StringBuilder(String)

參數

範例

備註

適用於

StringBuilder(Int32, Int32)

參數

例外狀況

範例

備註

給呼叫者的注意事項

另請參閱

適用於

StringBuilder(String, Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

StringBuilder(String, Int32, Int32, Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

其他資源