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

Исходный код:

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)

Исходный код:

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)

Исходный код:

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 это 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)

Исходный код:

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 меньше одного, 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)

Исходный код:

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 это nullтак, новое StringBuilder будет содержать пустую строку (т. е. она содержит Empty).

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)

Исходный код:

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 это nullтак, новое StringBuilder будет содержать пустую строку (т. е. она содержит Empty).

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