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

Инициализирует новый экземпляр класса StringBuilder.

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

Примеры

В следующем примере показано, как вызвать StringBuilder конструктор без параметров.

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

Комментарии

Строковое значение этого экземпляра имеет значение String.Empty, а емкость устанавливается в качестве емкости по умолчанию для конкретной реализации.

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

StringBuilder(Int32)

Инициализирует новый экземпляр класса 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 = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Комментарии

Параметр capacity определяет максимальное количество символов, которые могут храниться в памяти, выделенной текущим экземпляром. Его значение присваивается свойству Capacity . Если число символов, хранящихся в текущем экземпляре, превышает это capacity значение, StringBuilder объект выделяет дополнительную память для их хранения.

Строковое значение этого экземпляра имеет значение String.Empty. Если capacity значение равно нулю, используется емкость по умолчанию для конкретной реализации.

См. также раздел

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

StringBuilder(String)

Инициализирует новый экземпляр класса 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);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Комментарии

Если value равно null, то новый StringBuilder будет содержать пустую строку (то есть, он содержит Empty).

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

StringBuilder(Int32, Int32)

Инициализирует новый экземпляр класса 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 меньше единицы, 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);
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)

Инициализирует новый экземпляр класса 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 = 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 определяет максимальное количество символов, которые могут храниться в памяти, выделенной текущим экземпляром. Его значение присваивается свойству Capacity . Если число символов, хранящихся в текущем экземпляре, превышает это capacity значение, StringBuilder объект выделяет дополнительную память для их хранения.

Если capacity значение равно нулю, используется емкость по умолчанию для конкретной реализации.

См. также раздел

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

StringBuilder(String, Int32, Int32, Int32)

Инициализирует новый экземпляр класса 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 = 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 определяет максимальное количество символов, которые могут храниться в памяти, выделенной текущим экземпляром. Его значение присваивается свойству Capacity . Если число символов, хранящихся в текущем экземпляре, превышает это capacity значение, StringBuilder объект выделяет дополнительную память для их хранения.

Если capacity значение равно нулю, используется емкость по умолчанию для конкретной реализации.

См. также раздел

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