StringBuilder 构造函数

定义

命名空间:

System.Text

程序集:

netstandard.dll, 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()

Source:

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)

Source:

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)

Source:

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，则新StringBuilder字符串将包含空字符串（即，它包含Empty）。null

示例

以下示例演示如何使用指定的字符串调用 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，则新StringBuilder字符串将包含空字符串（即，它包含Empty）。null

StringBuilder(Int32, Int32)

Source:

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 小于零或 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)

Source:

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，则新StringBuilder字符串将包含空字符串（即，它包含Empty）。null

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)

Source:

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，则新StringBuilder字符串将包含空字符串（即，它包含Empty）。null

startIndex

Int32

子字符串开始的位置 value 。

length

Int32

子字符串中的字符数。

capacity

Int32

建议的 StringBuilder起始大小 。

例外

ArgumentOutOfRangeException

capacity 小于零。

-或-

startIndex 加号 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