语言

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()

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

初始化 StringBuilder 类的新实例。

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

示例

以下示例演示如何在没有参数的情况下调用 StringBuilder 构造函数。

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

注解

此实例的字符串值设置为 String.Empty,容量设置为特定于实现的默认容量。

适用于

StringBuilder(Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
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

此实例的建议起始大小。

例外

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 为零,则使用特定于实现的默认容量。

另请参阅

适用于

StringBuilder(String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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 = "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)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
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

当前字符串可以包含的最大字符数。

例外

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) 方法以追加小字符串时,会出现这种情况。

另请参阅

适用于

StringBuilder(String, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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起始大小 。

例外

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 为零,则使用特定于实现的默认容量。

另请参阅

适用于

StringBuilder(String, Int32, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs
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);
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起始大小 。

例外

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 为零,则使用特定于实现的默认容量。

另请参阅

适用于