StringBuilder Класс

Определение

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

System.Text

Сборка:

System.Runtime.dll

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

StringBuilder.cs

Представляет изменяемую строку символов. Этот класс не может быть унаследован.

public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable

public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Наследование

Object

StringBuilder

Реализации

ISerializable

Примеры

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

using namespace System;
using namespace System::Text;

int main()
{
    // Create a StringBuilder that expects to hold 50 characters.
    // Initialize the StringBuilder with "ABC".
    StringBuilder^ sb = gcnew StringBuilder("ABC", 50);

    // Append three characters (D, E, and F) to the end of the
    // StringBuilder.
    sb->Append(gcnew array<Char>{'D', 'E', 'F'});

    // Append a format string to the end of the StringBuilder.
    sb->AppendFormat("GHI{0}{1}", (Char)'J', (Char)'k');

    // Display the number of characters in the StringBuilder
    // and its string.
    Console::WriteLine("{0} chars: {1}", sb->Length, sb->ToString());

    // Insert a string at the beginning of the StringBuilder.
    sb->Insert(0, "Alphabet: ");

    // Replace all lowercase k's with uppercase K's.
    sb->Replace('k', 'K');

    // Display the number of characters in the StringBuilder
    // and its string.
    Console::WriteLine("{0} chars: {1}", sb->Length, sb->ToString());
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

using System;
using System.Text;

public sealed class App
{
    static void Main()
    {
        // Create a StringBuilder that expects to hold 50 characters.
        // Initialize the StringBuilder with "ABC".
        StringBuilder sb = new StringBuilder("ABC", 50);

        // Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(new char[] { 'D', 'E', 'F' });

        // Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", 'J', 'k');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());

        // Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ");

        // Replace all lowercase k's with uppercase K's.
        sb.Replace('k', 'K');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());
    }
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

open System.Text

// Create a StringBuilder that expects to hold 50 characters.
// Initialize the StringBuilder with "ABC".
let sb = StringBuilder("ABC", 50)

// Append three characters (D, E, and F) to the end of the StringBuilder.
sb.Append [| 'D'; 'E'; 'F' |] |> ignore

// Append a format string to the end of the StringBuilder.
sb.AppendFormat("GHI{0}{1}", 'J', 'k') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// Insert a string at the beginning of the StringBuilder.
sb.Insert(0, "Alphabet: ") |> ignore

// Replace all lowercase k's with uppercase K's.
sb.Replace('k', 'K') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

Imports System.Text

Public Module App 
    Public Sub Main() 
        ' Create a StringBuilder that expects to hold 50 characters.
        ' Initialize the StringBuilder with "ABC".
        Dim sb As New StringBuilder("ABC", 50)

        ' Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(New Char() {"D"c, "E"c, "F"c})

        ' Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", "J"c, "k"c)

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())

        ' Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ")

        ' Replace all lowercase k's with uppercase K's.
        sb.Replace("k", "K")

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())
    End Sub
End Module

' This code produces the following output.
'
' 11 chars: ABCDEFGHIJk
' 21 chars: Alphabet: ABCDEFGHIJK

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для StringBuilder.

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

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

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

StringBuilder()	Инициализирует новый экземпляр класса StringBuilder.
StringBuilder(Int32)	Инициализирует новый экземпляр класса StringBuilder с помощью указанной емкости.
StringBuilder(Int32, Int32)	Инициализирует новый экземпляр класса StringBuilder, который начинается с указанной емкости и может увеличиваться до указанного максимума.
StringBuilder(String)	Инициализирует новый экземпляр класса StringBuilder с помощью указанной строки.
StringBuilder(String, Int32)	Инициализирует новый экземпляр класса StringBuilder с помощью указанной строки и емкости.
StringBuilder(String, Int32, Int32, Int32)	Инициализирует новый экземпляр класса StringBuilder из указанной подстроки и емкости.

Свойства

Capacity	Возвращает или задает максимальное количество символов, которые могут содержаться в памяти, выделенной текущим экземпляром.
Chars[Int32]	Возвращает или задает символ в указанной позиции символа в этом экземпляре.
Length	Возвращает или задает длину текущего объекта StringBuilder.
MaxCapacity	Получает максимальную емкость этого экземпляра.

Методы

Append(Boolean)	Добавляет строковое представление указанного логического значения в этот экземпляр.
Append(Byte)	Добавляет строковое представление указанного 8-разрядного целого числа без знака в этот экземпляр.
Append(Char)	Добавляет строковое представление указанного объекта Char в этот экземпляр.
Append(Char*, Int32)	Добавляет массив символов Юникода, начиная с указанного адреса в этот экземпляр.
Append(Char, Int32)	Добавляет указанное количество копий строкового представления символа Юникода к этому экземпляру.
Append(Char[])	Добавляет строковое представление символов Юникода в указанном массиве к этому экземпляру.
Append(Char[], Int32, Int32)	Добавляет строковое представление указанного подаррейства символов Юникода к этому экземпляру.
Append(Decimal)	Добавляет строковое представление указанного десятичного числа в этот экземпляр.
Append(Double)	Добавляет строковое представление указанного числа с плавающей запятой двойной точности к этому экземпляру.
Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Добавляет указанную интерполированную строку в этот экземпляр с помощью указанного формата.
Append(Int16)	Добавляет строковое представление указанного 16-разрядного целого числа со знаком в этот экземпляр.
Append(Int32)	Добавляет строковое представление указанного 32-разрядного целого числа со знаком к этому экземпляру.
Append(Int64)	Добавляет строковое представление указанного 64-разрядного целого числа со знаком в этот экземпляр.
Append(Object)	Добавляет строковое представление указанного объекта к этому экземпляру.
Append(ReadOnlyMemory<Char>)	Добавляет строковое представление указанной области памяти только для чтения в этот экземпляр.
Append(ReadOnlySpan<Char>)	Добавляет строковое представление указанного диапазона символов только для чтения в этот экземпляр.
Append(SByte)	Добавляет строковое представление указанного 8-разрядного целого числа со знаком в этот экземпляр.
Append(Single)	Добавляет строковое представление указанного числа с плавающей запятой с одной точностью к этому экземпляру.
Append(String)	Добавляет копию указанной строки в этот экземпляр.
Append(String, Int32, Int32)	Добавляет копию указанной подстроки к этому экземпляру.
Append(StringBuilder)	Добавляет строковое представление указанного построителя строк в этот экземпляр.
Append(StringBuilder, Int32, Int32)	Добавляет копию подстроки в указанный построитель строк в этот экземпляр.
Append(StringBuilder+AppendInterpolatedStringHandler)	Добавляет указанную интерполированную строку в этот экземпляр.
Append(UInt16)	Добавляет строковое представление указанного 16-разрядного целого числа без знака к этому экземпляру.
Append(UInt32)	Добавляет строковое представление указанного 32-разрядного целого числа без знака к этому экземпляру.
Append(UInt64)	Добавляет строковое представление указанного 64-разрядного целого числа без знака в этот экземпляр.
AppendFormat(IFormatProvider, CompositeFormat, Object[])	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из аргументов с помощью указанного поставщика формата.
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из аргументов с помощью указанного поставщика формата.
AppendFormat(IFormatProvider, String, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением одного аргумента с помощью указанного поставщика формата.
AppendFormat(IFormatProvider, String, Object, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением одного из двух аргументов с помощью указанного поставщика формата.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из трех аргументов с помощью указанного поставщика формата.
AppendFormat(IFormatProvider, String, Object[])	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением соответствующего аргумента в массиве параметров с помощью указанного поставщика формата.
AppendFormat(String, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением одного аргумента.
AppendFormat(String, Object, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением одного из двух аргументов.
AppendFormat(String, Object, Object, Object)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из трех аргументов.
AppendFormat(String, Object[])	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением соответствующего аргумента в массиве параметров.
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из аргументов с помощью указанного поставщика формата.
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из аргументов с помощью указанного поставщика формата.
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	Добавляет строку, возвращаемую путем обработки составной строки форматирования, содержащей к этому экземпляру ноль или больше элементов формата. Каждый элемент формата заменяется строковым представлением любого из аргументов с помощью указанного поставщика формата.
AppendJoin(Char, Object[])	Объединяет строковые представления элементов в предоставленном массиве объектов, используя указанный разделитель символов между каждым элементом, а затем добавляет результат к текущему экземпляру построителя строк.
AppendJoin(Char, String[])	Объединяет строки предоставленного массива, используя указанный разделитель символов между каждой строкой, а затем добавляет результат к текущему экземпляру построителя строк.
AppendJoin(String, Object[])	Объединяет строковые представления элементов в предоставленном массиве объектов, используя указанный разделитель между каждым элементом, а затем добавляет результат к текущему экземпляру построителя строк.
AppendJoin(String, String[])	Объединяет строки предоставленного массива, используя указанный разделитель между каждой строкой, а затем добавляет результат к текущему экземпляру построителя строк.
AppendJoin<T>(Char, IEnumerable<T>)	Объединяет и добавляет элементы коллекции, используя указанный разделитель символов между каждым элементом.
AppendJoin<T>(String, IEnumerable<T>)	Объединяет и добавляет элементы коллекции, используя указанный разделитель между каждым элементом.
AppendLine()	Добавляет конечный элемент строки по умолчанию к концу текущего объекта StringBuilder.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Добавляет указанную интерполированную строку с помощью указанного формата, за которым следует конечный элемент строки по умолчанию, к концу текущего объекта StringBuilder.
AppendLine(String)	Добавляет копию указанной строки, за которой следует конечный элемент строки по умолчанию, в конец текущего объекта StringBuilder.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Добавляет указанную интерполированную строку, за которой следует конечный элемент строки по умолчанию в конец текущего объекта StringBuilder.
Clear()	Удаляет все символы из текущего экземпляра StringBuilder.
CopyTo(Int32, Char[], Int32, Int32)	Копирует символы из указанного сегмента этого экземпляра в указанный сегмент целевого Char массива.
CopyTo(Int32, Span<Char>, Int32)	Копирует символы из указанного сегмента этого экземпляра в целевой Char диапазон.
EnsureCapacity(Int32)	Гарантирует, что емкость этого экземпляра StringBuilder не менее указанного значения.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Equals(ReadOnlySpan<Char>)	Возвращает значение, указывающее, равны ли символы в этом экземпляре символам в указанном диапазоне символов только для чтения.
Equals(StringBuilder)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.
GetChunks()	Возвращает объект, который можно использовать для итерации с помощью блоков символов, представленных в ReadOnlyMemory<Char> созданном из этого экземпляра StringBuilder.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Insert(Int32, Boolean)	Вставляет строковое представление логического значения в этот экземпляр по указанной позиции символа.
Insert(Int32, Byte)	Вставляет строковое представление указанного 8-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, Char)	Вставляет строковое представление указанного символа Юникода в этот экземпляр в указанной позиции символа.
Insert(Int32, Char[])	Вставляет строковое представление указанного массива символов Юникода в этот экземпляр по указанной позиции символов.
Insert(Int32, Char[], Int32, Int32)	Вставляет строковое представление указанных вложенных символов Юникода в этот экземпляр по указанной позиции символов.
Insert(Int32, Decimal)	Вставляет строковое представление десятичного числа в этот экземпляр в указанной позиции символа.
Insert(Int32, Double)	Вставляет строковое представление числа с плавающей запятой двойной точности в этот экземпляр в указанной позиции символа.
Insert(Int32, Int16)	Вставляет строковое представление указанного 16-разрядного целого числа со знаком в этот экземпляр по указанной позиции символа.
Insert(Int32, Int32)	Вставляет строковое представление указанного 32-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, Int64)	Вставляет строковое представление 64-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, Object)	Вставляет строковое представление объекта в этот экземпляр по указанной позиции символа.
Insert(Int32, ReadOnlySpan<Char>)	Вставляет последовательность символов в этот экземпляр по указанному расположению символов.
Insert(Int32, SByte)	Вставляет строковое представление указанного 8-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, Single)	Вставляет строковое представление числа с плавающей запятой с одной точностью в этот экземпляр в указанной позиции символа.
Insert(Int32, String)	Вставляет строку в этот экземпляр в указанное положение символов.
Insert(Int32, String, Int32)	Вставляет одну или несколько копий указанной строки в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt16)	Вставляет строковое представление 16-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt32)	Вставляет строковое представление 32-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt64)	Вставляет строковое представление 64-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Remove(Int32, Int32)	Удаляет указанный диапазон символов из этого экземпляра.
Replace(Char, Char)	Заменяет все вхождения указанного символа в этом экземпляре другим указанным символом.
Replace(Char, Char, Int32, Int32)	Заменяет в подстроку этого экземпляра все вхождения указанного символа другим заданным символом.
Replace(String, String)	Заменяет все вхождения указанной строки в этом экземпляре другой указанной строкой.
Replace(String, String, Int32, Int32)	Заменяет в подстроке этого экземпляра все вхождения указанной строки другой указанной строкой.
ToString()	Преобразует значение этого экземпляра в String.
ToString(Int32, Int32)	Преобразует значение подстроки этого экземпляра в String.

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для десериализации текущего объекта StringBuilder.

Методы расширения

Append(StringBuilder, StringSegment)	Добавьте указанный StringSegment в StringBuilder.
AppendRedacted(StringBuilder, Redactor, ReadOnlySpan<Char>)	Редактирует потенциально конфиденциальные данные и добавляет его в экземпляр StringBuilder.
AppendRedacted(StringBuilder, Redactor, String)	Редактирует потенциально конфиденциальные данные и добавляет его в экземпляр StringBuilder.

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

• String