StringBuilder 构造函数

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

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，容量设置为特定于实现的默认容量。

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

public:
 StringBuilder(int capacity);

public StringBuilder (int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

参数

例外

示例

以下示例演示如何调用具有指定容量的 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

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

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)

参数

示例

以下示例演示如何使用指定的字符串调用 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）。

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

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)

参数

例外

示例

以下示例演示如何调用 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 对象会分配额外的内存来存储这些字符。

如果 capacity 为零，则使用特定于实现的默认容量。

属性 maxCapacity 定义当前实例可以容纳的最大字符数。 其值分配给 MaxCapacity 属性。 如果要存储在当前实例中的字符数超过此值 maxCapacity ，则 StringBuilder 对象不会分配额外的内存，而是引发异常。

调用方说明

在 .NET Core 和 .NET Framework 4.0 及更高版本中，通过调用 StringBuilder(Int32, Int32) 构造函数实例化 StringBuilder 对象时，实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String) 和 AppendFormat(String, Object) 方法以追加小字符串时，可能会出现这种情况。

另请参阅

• Capacity
• MaxCapacity

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

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)

参数

例外

示例

以下示例演示如何使用初始字符串和指定的容量调用 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 对象会分配额外的内存来存储这些字符。

如果 capacity 为零，则使用特定于实现的默认容量。

另请参阅

• Capacity

Source:

StringBuilder.cs

Source:

StringBuilder.cs

Source:

StringBuilder.cs

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)

参数

例外

示例

以下示例演示如何使用指定的字符串调用 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 对象会分配额外的内存来存储这些字符。

如果 capacity 为零，则使用特定于实现的默认容量。

另请参阅

• Capacity