StringBuilder Конструкторы

Ссылка

Определение

Пространство имен:: System.Text

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.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.cs

Исходный код:: StringBuilder.cs

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

public:
 StringBuilder();

public StringBuilder ();

Public Sub New ()

Примеры

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

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

StringBuilder(Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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 = 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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

StringBuilder(String)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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 = 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)

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

StringBuilder(Int32, Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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 = 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)

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

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

StringBuilder(String, Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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

capacity: Int32

Предлагаемый начальный размер StringBuilder.

Исключения

ArgumentOutOfRangeException

Значение параметра 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);

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

StringBuilder(String, Int32, Int32, Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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.

Исключения

ArgumentOutOfRangeException

Значение параметра 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);

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

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

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Поделиться через

StringBuilder Конструкторы

Определение

Перегрузки

StringBuilder()

Примеры

Комментарии

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

StringBuilder(Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

StringBuilder(String)

Параметры

Примеры

Комментарии

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

StringBuilder(Int32, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

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

StringBuilder(String, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

StringBuilder(String, Int32, Int32, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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