StringBuilder Klasa

Definicja

Przestrzeń nazw:

System.Text

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

StringBuilder.cs

Reprezentuje modyfikowalny ciąg znaków. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

StringBuilder

Implementuje

ISerializable

Przykłady

W poniższym przykładzie pokazano, jak wywołać wiele metod zdefiniowanych przez klasę StringBuilder .

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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla elementu StringBuilder.

Notatki dotyczące wywoływania

W .NET Core i w programie .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder może wzrosnąć poza wartość właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Konstruktory

Nazwa	Opis
StringBuilder()	Inicjuje nowe wystąpienie klasy StringBuilder.
StringBuilder(Int32, Int32)	Inicjuje nowe wystąpienie StringBuilder klasy rozpoczynającej się od określonej pojemności i może wzrosnąć do określonej wartości maksymalnej.
StringBuilder(Int32)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonej pojemności.
StringBuilder(String, Int32, Int32, Int32)	Inicjuje nowe wystąpienie StringBuilder klasy z określonego podciągu i pojemności.
StringBuilder(String, Int32)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonego ciągu i pojemności.
StringBuilder(String)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonego ciągu.

Właściwości

Nazwa	Opis
Capacity	Pobiera lub ustawia maksymalną liczbę znaków, które mogą być zawarte w pamięci przydzielonej przez bieżące wystąpienie.
Chars[Int32]	Pobiera lub ustawia znak na określonej pozycji znaku w tym wystąpieniu.
Length	Pobiera lub ustawia długość bieżącego StringBuilder obiektu.
MaxCapacity	Pobiera maksymalną pojemność tego wystąpienia.

Metody

Nazwa	Opis
Append(Boolean)	Dołącza do tego wystąpienia reprezentację ciągu określonej wartości logicznej.
Append(Byte)	Dołącza reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku do tego wystąpienia.
Append(Char, Int32)	Dołącza określoną liczbę kopii ciągu reprezentujących znak Unicode do tego wystąpienia.
Append(Char)	Dołącza do tego wystąpienia reprezentację ciągu określonego Char obiektu.
Append(Char[], Int32, Int32)	Dołącza do tego wystąpienia reprezentację ciągu określonego podarrału znaków Unicode.
Append(Char[])	Dołącza do tego wystąpienia reprezentację ciągu znaków Unicode w określonej tablicy.
Append(Char*, Int32)	Dołącza tablicę znaków Unicode rozpoczynających się od określonego adresu do tego wystąpienia.
Append(Decimal)	Dołącza do tego wystąpienia reprezentację ciągu określonej liczby dziesiętnej.
Append(Double)	Dołącza ciąg reprezentujący określoną liczbę zmiennoprzecinkową o podwójnej precyzji do tego wystąpienia.
Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Dołącza określony ciąg interpolowany do tego wystąpienia przy użyciu określonego formatu.
Append(Int16)	Dołącza do tego wystąpienia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem.
Append(Int32)	Dołącza do tego wystąpienia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem.
Append(Int64)	Dołącza do tego wystąpienia reprezentację ciągu określonej 64-bitowej liczby całkowitej ze znakiem.
Append(Object)	Dołącza do tego wystąpienia reprezentację ciągu określonego obiektu.
Append(ReadOnlyMemory<Char>)	Dołącza do tego wystąpienia reprezentację ciągu określonego regionu pamięci tylko do odczytu.
Append(ReadOnlySpan<Char>)	Dołącza reprezentację ciągu określonego zakresu znaków tylko do odczytu do tego wystąpienia.
Append(SByte)	Dołącza do tego wystąpienia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem.
Append(Single)	Dołącza do tego wystąpienia reprezentację ciągu określonej liczby zmiennoprzecinkowa o pojedynczej precyzji.
Append(String, Int32, Int32)	Dołącza kopię określonego podciągu do tego wystąpienia.
Append(String)	Dołącza kopię określonego ciągu do tego wystąpienia.
Append(StringBuilder, Int32, Int32)	Dołącza kopię podciągów w określonym konstruktorze ciągów do tego wystąpienia.
Append(StringBuilder)	Dołącza do tego wystąpienia reprezentację ciągu określonego konstruktora ciągów.
Append(StringBuilder+AppendInterpolatedStringHandler)	Dołącza określony ciąg interpolowany do tego wystąpienia.
Append(UInt16)	Dołącza do tego wystąpienia reprezentację ciągu o określonej 16-bitowej liczbie całkowitej bez znaku.
Append(UInt32)	Dołącza reprezentację ciągu określonej 32-bitowej liczby całkowitej bez znaku do tego wystąpienia.
Append(UInt64)	Dołącza reprezentację ciągu określonej 64-bitowej liczby całkowitej bez znaku do tego wystąpienia.
AppendFormat(IFormatProvider, CompositeFormat, Object[])	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący jeden z trzech argumentów przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, String, Object, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, String, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, String, Object[])	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów przy użyciu określonego dostawcy formatu.
AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów przy użyciu określonego dostawcy formatu.
AppendFormat(String, Object, Object, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z trzech argumentów.
AppendFormat(String, Object, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów.
AppendFormat(String, Object)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu.
AppendFormat(String, Object[])	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów.
AppendFormat(String, ReadOnlySpan<Object>)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów.
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.
AppendJoin(Char, Object[])	Łączy reprezentacje ciągów elementów w podanej tablicy obiektów przy użyciu określonego separatora znaków między każdym elementem członkowskim, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(Char, ReadOnlySpan<Object>)	Łączy reprezentacje ciągów elementów w podanym zakresie obiektów przy użyciu określonego separatora znaków między każdym elementem członkowskim, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(Char, ReadOnlySpan<String>)	Łączy ciągi podanego zakresu przy użyciu określonego separatora znaków między poszczególnymi ciągami, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(Char, String[])	Łączy ciągi dostarczonej tablicy przy użyciu określonego separatora znaków między poszczególnymi ciągami, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(String, Object[])	Łączy reprezentacje ciągów elementów w podanej tablicy obiektów przy użyciu określonego separatora między każdym elementem członkowskim, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(String, ReadOnlySpan<Object>)	Łączy reprezentacje ciągów elementów w podanym zakresie obiektów przy użyciu określonego separatora między każdym elementem członkowskim, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(String, ReadOnlySpan<String>)	Łączy ciągi podanego zakresu przy użyciu określonego separatora między poszczególnymi ciągami, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin(String, String[])	Łączy ciągi dostarczonej tablicy przy użyciu określonego separatora między poszczególnymi ciągami, a następnie dołącza wynik do bieżącego wystąpienia konstruktora ciągów.
AppendJoin<T>(Char, IEnumerable<T>)	Łączy i dołącza elementy członkowskie kolekcji przy użyciu określonego separatora znaków między każdym elementem członkowskim.
AppendJoin<T>(String, IEnumerable<T>)	Łączy i dołącza elementy członkowskie kolekcji przy użyciu określonego separatora między każdym elementem członkowskim.
AppendLine()	Dołącza domyślny terminator wiersza na końcu bieżącego StringBuilder obiektu.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Dołącza określony ciąg interpolowany przy użyciu określonego formatu, po którym następuje domyślny terminator wiersza, na końcu bieżącego obiektu StringBuilder.
AppendLine(String)	Dołącza kopię określonego ciągu, po której następuje domyślny terminator wiersza na końcu bieżącego StringBuilder obiektu.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Dołącza określony ciąg interpolowany, po którym następuje domyślny terminator wiersza na końcu bieżącego obiektu StringBuilder.
Clear()	Usuwa wszystkie znaki z bieżącego StringBuilder wystąpienia.
CopyTo(Int32, Char[], Int32, Int32)	Kopiuje znaki z określonego segmentu tego wystąpienia do określonego segmentu tablicy docelowej Char .
CopyTo(Int32, Span<Char>, Int32)	Kopiuje znaki z określonego segmentu tego wystąpienia do zakresu docelowego Char .
EnsureCapacity(Int32)	Gwarantuje, że pojemność tego wystąpienia StringBuilder jest co najmniej określoną wartością.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
Equals(ReadOnlySpan<Char>)	Zwraca wartość wskazującą, czy znaki w tym wystąpieniu są równe znakom w określonym zakresie znaków tylko do odczytu.
Equals(StringBuilder)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.
GetChunks()	Zwraca obiekt, który może służyć do iterowania fragmentów znaków reprezentowanych w utworzonym ReadOnlyMemory<Char> na podstawie tego StringBuilder wystąpienia.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
Insert(Int32, Boolean)	Wstawia ciąg reprezentujący wartość logiczną do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Byte)	Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Char)	Wstawia do tego wystąpienia reprezentację ciągu określonego znaku Unicode w określonym położeniu znaku.
Insert(Int32, Char[], Int32, Int32)	Wstawia reprezentację ciągu określonego podarray znaków Unicode do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Char[])	Wstawia reprezentację ciągu określonej tablicy znaków Unicode w tym wystąpieniu w określonym położeniu znaku.
Insert(Int32, Decimal)	Wstawia ciąg reprezentujący liczbę dziesiętną do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Double)	Wstawia do tego wystąpienia reprezentację ciągu o podwójnej precyzji liczby zmiennoprzecinkowych w określonym położeniu znaku.
Insert(Int32, Int16)	Wstawia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Int32)	Wstawia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Int64)	Wstawia reprezentację ciągu 64-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Object)	Wstawia reprezentację ciągu obiektu w tym wystąpieniu w określonym położeniu znaku.
Insert(Int32, ReadOnlySpan<Char>)	Wstawia sekwencję znaków do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, SByte)	Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Single)	Wstawia ciąg reprezentujący liczbę zmiennoprzecinkową o pojedynczej precyzji do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, String, Int32)	Wstawia co najmniej jedną kopię określonego ciągu do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, String)	Wstawia ciąg do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, UInt16)	Wstawia reprezentację ciągu 16-bitowej liczby całkowitej bez znaku do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, UInt32)	Wstawia do tego wystąpienia reprezentację ciągu 32-bitowej liczby całkowitej bez znaku w określonym położeniu znaku.
Insert(Int32, UInt64)	Wstawia do tego wystąpienia reprezentację ciągu 64-bitowej liczby całkowitej bez znaku w określonym położeniu znaku.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Remove(Int32, Int32)	Usuwa określony zakres znaków z tego wystąpienia.
Replace(Char, Char, Int32, Int32)	Zamienia w podciąg tego wystąpienia wszystkie wystąpienia określonego znaku na inny określony znak.
Replace(Char, Char)	Zastępuje wszystkie wystąpienia określonego znaku w tym wystąpieniu innym określonym znakiem.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)	Zastępuje wszystkie wystąpienia jednego zakresu znaków tylko do odczytu innym w części tego konstruktora.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Zastępuje wszystkie wystąpienia jednego zakresu znaków tylko do odczytu innym w tym konstruktorze.
Replace(String, String, Int32, Int32)	Zamienia ciąg w podciąg tego wystąpienia wszystkie wystąpienia określonego ciągu za pomocą innego określonego ciągu.
Replace(String, String)	Zastępuje wszystkie wystąpienia określonego ciągu w tym wystąpieniu innym określonym ciągiem.
ToString()	Konwertuje wartość tego wystąpienia na Stringwartość .
ToString(Int32, Int32)	Konwertuje wartość podciągów tego wystąpienia na .String

Jawne implementacje interfejsu

Nazwa	Opis
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Wypełnia obiekt danymi niezbędnymi do deserializacji bieżącego StringBuilder obiektu.

Zobacz też

• String