StringBuilder StringBuilder StringBuilder StringBuilder Constructors

Определение

Перегрузки

StringBuilder() StringBuilder() StringBuilder()

Инициализирует новый экземпляр класса StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Инициализирует новый экземпляр класса StringBuilder, используя указанную емкость.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Инициализирует новый экземпляр класса StringBuilder, используя указанную строку.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32)

Инициализирует новый экземпляр класса StringBuilder, который начинается с указанной емкости и может увеличиваться до указанного максимального значения.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Инициализирует новый экземпляр класса StringBuilder, используя указанную строку и емкость.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Инициализирует новый экземпляр класса StringBuilder из указанной подстроки и емкости.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder() StringBuilder() StringBuilder()

Инициализирует новый экземпляр класса StringBuilder.Initializes a new instance of the StringBuilder class.

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

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор без параметров.The following example demonstrates how to call the StringBuilder constructor with no parameters.

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

Комментарии

Строковое значение этого экземпляра String.Emptyравно, а для емкости устанавливается емкость по умолчанию, зависящая от реализации.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Инициализирует новый экземпляр класса StringBuilder, используя указанную емкость.Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

Параметры

capacity
Int32 Int32 Int32 Int32

Предлагаемый начальный размер этого экземпляра.The suggested starting size of this instance.

Исключения

Значение параметра capacity меньше нуля.capacity is less than zero.

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор с заданной емкостью.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Комментарии

capacity Параметр определяет максимальное число символов, которые могут храниться в памяти, выделенной текущим экземпляром.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Его значение присваивается Capacity свойству.Its value is assigned to the Capacity property. Если число символов capacity StringBuilder , сохраняемых в текущем экземпляре, превышает это значение, объект выделяет дополнительную память для их хранения.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Строковое значение этого экземпляра String.Emptyравно.The string value of this instance is set to String.Empty. Если capacity значение равно нулю, то используется емкость по умолчанию, зависящая от реализации.If capacity is zero, the implementation-specific default capacity is used.

Дополнительно

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Инициализирует новый экземпляр класса StringBuilder, используя указанную строку.Initializes a new instance of the StringBuilder class using the specified string.

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 String String String

Строка, используемая для инициализации значения экземпляра.The string used to initialize the value of the instance. Если value равно null, то новый StringBuilder будет содержать пустую строку (то есть, он содержит Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор с указанной строкой.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Комментарии

Если value равно null, то новый StringBuilder будет содержать пустую строку (то есть, он содержит Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32)

Инициализирует новый экземпляр класса StringBuilder, который начинается с указанной емкости и может увеличиваться до указанного максимального значения.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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 Int32 Int32 Int32

Предлагаемый начальный размер StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32 Int32 Int32 Int32

Наибольшее допустимое количество знаков в текущей строке.The maximum number of characters the current string can contain.

Исключения

maxCapacity меньше единицы, capacity меньше нуля, или capacity больше maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор с заданной емкостью и максимальной емкостью.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Комментарии

capacity Параметр определяет максимальное число символов, которые могут храниться в памяти, выделенной текущим экземпляром.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Его значение присваивается Capacity свойству.Its value is assigned to the Capacity property. Если число символов capacity StringBuilder , сохраняемых в текущем экземпляре, превышает это значение, объект выделяет дополнительную память для их хранения.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Если capacity значение равно нулю, то используется емкость по умолчанию, зависящая от реализации.If capacity is zero, the implementation-specific default capacity is used.

maxCapacity Свойство определяет максимальное число символов, которое может храниться в текущем экземпляре.The maxCapacity property defines the maximum number of characters that the current instance can hold. Его значение присваивается MaxCapacity свойству.Its value is assigned to the MaxCapacity property. Если число символов maxCapacity StringBuilder , сохраняемых в текущем экземпляре, превышает это значение, объект не выделяет дополнительную память, а вместо этого создает исключение.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

Примечания для тех, кто вызывает этот метод

В .NET Core и в .NET Framework 4,0 StringBuilder и более поздних версиях при создании экземпляра объекта путем StringBuilder(Int32, Int32) вызова конструктора длина StringBuilder и емкость экземпляра могут увеличиваться за пределами значения его свойств MaxCapacity свойства.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Это может произойти в частности при вызове Append(String) методов AppendFormat(String, Object) и для добавления небольших строк.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Дополнительно

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Инициализирует новый экземпляр класса StringBuilder, используя указанную строку и емкость.Initializes a new instance of the StringBuilder class using the specified string and capacity.

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 String String String

Строка, используемая для инициализации значения экземпляра.The string used to initialize the value of the instance. Если value равно null, то новый StringBuilder будет содержать пустую строку (то есть, он содержит Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32 Int32 Int32 Int32

Предлагаемый начальный размер StringBuilder.The suggested starting size of the StringBuilder.

Исключения

Значение параметра capacity меньше нуля.capacity is less than zero.

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор с начальной строкой и заданной емкостью.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

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);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Комментарии

capacity Параметр определяет максимальное число символов, которые могут храниться в памяти, выделенной текущим экземпляром.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Его значение присваивается Capacity свойству.Its value is assigned to the Capacity property. Если число символов capacity StringBuilder , сохраняемых в текущем экземпляре, превышает это значение, объект выделяет дополнительную память для их хранения.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Если capacity значение равно нулю, то используется емкость по умолчанию, зависящая от реализации.If capacity is zero, the implementation-specific default capacity is used.

Дополнительно

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Инициализирует новый экземпляр класса StringBuilder из указанной подстроки и емкости.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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 String String String

Строка, содержащая подстроку, применяемую для инициализации значения этого экземпляра.The string that contains the substring used to initialize the value of this instance. Если value равно null, то новый StringBuilder будет содержать пустую строку (то есть, он содержит Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32 Int32 Int32 Int32

Позиция в пределах value, с которой начинается подстрока.The position within value where the substring begins.

length
Int32 Int32 Int32 Int32

Число символов в подстроке.The number of characters in the substring.

capacity
Int32 Int32 Int32 Int32

Предлагаемый начальный размер StringBuilder.The suggested starting size of the StringBuilder.

Исключения

Значение параметра capacity меньше нуля.capacity is less than zero.

- или --or- startIndex плюс length не является позицией в value.startIndex plus length is not a position within value.

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор с указанной строкой.The following example demonstrates how to call the StringBuilder constructor with the specified string.

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);
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 Параметр определяет максимальное число символов, которые могут храниться в памяти, выделенной текущим экземпляром.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Его значение присваивается Capacity свойству.Its value is assigned to the Capacity property. Если число символов capacity StringBuilder , сохраняемых в текущем экземпляре, превышает это значение, объект выделяет дополнительную память для их хранения.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Если capacity значение равно нулю, то используется емкость по умолчанию, зависящая от реализации.If capacity is zero, the implementation-specific default capacity is used.

Дополнительно

Применяется к