StringBuilder Klasse

Definition

Namespace:

System.Text

Assembly:

mscorlib.dll

Stellt eine veränderbare Zeichenfolge von Zeichen dar. Diese Klasse kann nicht vererbt werden.

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

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Vererbung

Object

StringBuilder

Attribute

SerializableAttribute ComVisibleAttribute

Implementiert

ISerializable

Beispiele

Das folgende Beispiel zeigt, wie Viele der von der StringBuilder Klasse definierten Methoden aufgerufen werden.

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

Hinweise

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für StringBuilder.

Hinweise für Aufrufer

.NET Wenn Sie das -Objekt instanziieren, indem Sie den < .NET c1 />-Konstruktor aufrufen, können sowohl die Länge als auch die Kapazität der Instanz Instanz über den Wert seiner -Eigenschaft hinaus wachsen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Zeichenfolgen aufrufen und AppendFormat(String, Object) Methoden zum Anfügen kleiner Zeichenfolgen verwenden.

Konstruktoren

Name	Beschreibung
StringBuilder()	Initialisiert eine neue Instanz der StringBuilder-Klasse.
StringBuilder(Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder Klasse, die mit einer angegebenen Kapazität beginnt und auf ein angegebenes Maximum anwachsen kann.
StringBuilder(Int32)	Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Kapazität.
StringBuilder(String, Int32, Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder Klasse aus der angegebenen Teilzeichenfolge und Kapazität.
StringBuilder(String, Int32)	Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge und Kapazität.
StringBuilder(String)	Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge.

Eigenschaften

Name	Beschreibung
Capacity	Ruft die maximale Anzahl von Zeichen ab, die in dem speicher enthalten sein können, der von der aktuellen Instanz zugewiesen wird, oder legt diese fest.
Chars[Int32]	Dient zum Abrufen oder Festlegen des Zeichens an der angegebenen Zeichenposition in dieser Instanz.
Length	Dient zum Abrufen oder Festlegen der Länge des aktuellen StringBuilder Objekts.
MaxCapacity	Ruft die maximale Kapazität dieser Instanz ab.

Methoden

Name	Beschreibung
Append(Boolean)	Fügt die Zeichenfolgendarstellung eines angegebenen booleschen Werts an diese Instanz an.
Append(Byte)	Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahl ohne Vorzeichen an diese Instanz an.
Append(Char, Int32)	Fügt eine angegebene Anzahl von Kopien der Zeichenfolgendarstellung eines Unicode-Zeichens an diese Instanz an.
Append(Char)	Fügt die Zeichenfolgendarstellung eines angegebenen Char Objekts an diese Instanz an.
Append(Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen Unterarray von Unicode-Zeichen an diese Instanz an.
Append(Char[])	Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array an diese Instanz an.
Append(Char*, Int32)	Fügt ein Array von Unicode-Zeichen ab einer angegebenen Adresse an diese Instanz an.
Append(Decimal)	Fügt die Zeichenfolgendarstellung einer angegebenen Dezimalzahl an diese Instanz an.
Append(Double)	Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit doppelter Genauigkeit an diese Instanz an.
Append(Int16)	Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-ganzzahligen Vorzeichen an diese Instanz an.
Append(Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-ganzzahligen Vorzeichen an diese Instanz an.
Append(Int64)	Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-ganzzahligen Vorzeichen an diese Instanz an.
Append(Object)	Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.
Append(SByte)	Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahligen Vorzeichen an diese Instanz an.
Append(Single)	Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit an diese Instanz an.
Append(String, Int32, Int32)	Fügt eine Kopie einer angegebenen Teilzeichenfolge an diese Instanz an.
Append(String)	Fügt eine Kopie der angegebenen Zeichenfolge an diese Instanz an.
Append(UInt16)	Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.
Append(UInt32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-ganzzahl ohne Vorzeichen an diese Instanz an.
Append(UInt64)	Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der drei Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(IFormatProvider, String, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines von zwei Argumenten durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(IFormatProvider, String, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines einzelnen Arguments mithilfe eines angegebenen Formatanbieters ersetzt.
AppendFormat(IFormatProvider, String, Object[])	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray mithilfe eines angegebenen Formatanbieters ersetzt.
AppendFormat(String, Object, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der drei Argumente ersetzt.
AppendFormat(String, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines von zwei Argumenten ersetzt.
AppendFormat(String, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines einzelnen Arguments ersetzt.
AppendFormat(String, Object[])	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray ersetzt.
AppendLine()	Fügt den Standardzeilenterminator an das Ende des aktuellen StringBuilder Objekts an.
AppendLine(String)	Fügt eine Kopie der angegebenen Zeichenfolge gefolgt vom Standardzeilenterminator an das Ende des aktuellen StringBuilder Objekts an.
Clear()	Entfernt alle Zeichen aus der aktuellen StringBuilder Instanz.
CopyTo(Int32, Char[], Int32, Int32)	Kopiert die Zeichen aus einem angegebenen Segment dieser Instanz in ein angegebenes Segment eines Zielarrays Char .
EnsureCapacity(Int32)	Stellt sicher, dass die Kapazität dieser Instanz StringBuilder mindestens der angegebene Wert ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Equals(StringBuilder)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(Int32, Boolean)	Fügt die Zeichenfolgendarstellung eines booleschen Werts an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, Byte)	Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Char)	Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichens an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Char[])	Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichenarrays an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, Decimal)	Fügt die Zeichenfolgendarstellung einer Dezimalzahl an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, Double)	Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit doppelter Genauigkeit an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Int16)	Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl in diese Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Int64)	Fügt die Zeichenfolgendarstellung einer 64-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Object)	Fügt die Zeichenfolgendarstellung eines Objekts an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, SByte)	Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Single)	Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, String, Int32)	Fügt eine oder mehrere Kopien einer angegebenen Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, String)	Fügt an der angegebenen Zeichenposition eine Zeichenfolge in diese Instanz ein.
Insert(Int32, UInt16)	Fügt die Zeichenfolgendarstellung einer 16-Bit-Ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, UInt32)	Fügt die Zeichenfolgendarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, UInt64)	Fügt die Zeichenfolgendarstellung einer 64-Bit-ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Remove(Int32, Int32)	Entfernt den angegebenen Zeichenbereich aus dieser Instanz.
Replace(Char, Char, Int32, Int32)	Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen eines angegebenen Zeichens durch ein anderes angegebenes Zeichen.
Replace(Char, Char)	Ersetzt alle Vorkommen eines angegebenen Zeichens in dieser Instanz durch ein anderes angegebenes Zeichen.
Replace(String, String, Int32, Int32)	Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge.
Replace(String, String)	Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in dieser Instanz durch eine andere angegebene Zeichenfolge.
ToString()	Konvertiert den Wert dieser Instanz in ein String.
ToString(Int32, Int32)	Konvertiert den Wert einer Teilzeichenfolge dieser Instanz in eine String.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Füllt ein SerializationInfo Objekt mit den Daten auf, die zum Deserialisieren des aktuellen StringBuilder Objekts erforderlich sind.

Weitere Informationen

• String