1 von 3 fanden dies hilfreich - Dieses Thema bewerten.

StringBuilder-Klasse

.NET Framework 4.5

Andere Versionen

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

Vererbungshierarchie

System.Object
System.Text.StringBuilder

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class StringBuilder : ISerializable

Der StringBuilder-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	StringBuilder()	Initialisiert eine neue Instanz der StringBuilder-Klasse.
	StringBuilder(Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Kapazität.
	StringBuilder(String)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge.
	StringBuilder(Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse, die bei einer angegebenen Kapazität beginnt, die bis auf ein angegebenes Maximum erhöht werden kann.
	StringBuilder(String, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge und der angegebenen Kapazität.
	StringBuilder(String, Int32, Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Teilzeichenfolge und der angegebenen Kapazität.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Capacity	Ruft die Höchstanzahl von Zeichen ab, die im durch die aktuelle Instanz reservierten Speicher enthalten sein können, oder legt diese fest.
	Chars	Ruft das Zeichen an der angegebenen Zeichenposition in dieser Instanz ab oder legt dieses fest.
	Length	Ruft die Länge des aktuellen StringBuilder-Objekts ab oder legt diese fest.
	MaxCapacity	Ruft die maximale Kapazität dieser Instanz ab.

Zum Seitenanfang

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)	Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichens an diese Instanz an.
	Append(Char[])	Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array 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-Ganzzahl mit Vorzeichen an diese Instanz an.
	Append(Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.
	Append(Int64)	Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl mit 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-Ganzzahl mit Vorzeichen an diese Instanz an.
	Append(Single)	Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit 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.
	Append(Char, Int32)	Fügt eine angegebene Anzahl von Kopien der Zeichenfolgendarstellung eines Unicode-Zeichens an diese Instanz an.
	Append(Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an diese Instanz an.
	Append(String, Int32, Int32)	Fügt eine Kopie einer angegebenen Teilzeichenfolge dieser Instanz an.
	AppendFormat(String, Object)	Fügt die Zeichenfolge, die durch Verarbeitung einer kombinierten Formatzeichenfolge mit 0 (null) oder mehr Formatelementen zurückgegeben wurde, an diese Instanz an. Jedes Formatelement wird von der Zeichenfolgendarstellung eines einzelnen Arguments ersetzt.
	AppendFormat(String, Object[])	Fügt die Zeichenfolge, die durch Verarbeitung einer kombinierten Formatzeichenfolge mit 0 (null) oder mehr Formatelementen zurückgegeben wurde, an diese Instanz an. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray ersetzt.
	AppendFormat(IFormatProvider, String, Object[])	Fügt die Zeichenfolge, die durch Verarbeitung einer kombinierten Formatzeichenfolge mit 0 (null) oder mehr Formatelementen zurückgegeben wurde, an diese Instanz an. Jedes Formatelement wird von der Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray ersetzt, das einen angegebenen Formatanbieter verwendet.
	AppendFormat(String, Object, Object)	Fügt die Zeichenfolge, die durch Verarbeitung einer kombinierten Formatzeichenfolge mit 0 (null) oder mehr Formatelementen zurückgegeben wurde, an diese Instanz an. Jedes Formatelement wird durch die Zeichenfolgendarstellung für eines von zwei Argumenten ersetzt.
	AppendFormat(String, Object, Object, Object)	Fügt die Zeichenfolge, die durch Verarbeitung einer kombinierten Formatzeichenfolge mit 0 (null) oder mehr Formatelementen zurückgegeben wurde, an diese Instanz an. Jedes Formatelement wird durch die Zeichenfolgendarstellung für eines von drei Argumenten ersetzt.
	AppendLine()	Fügt das Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.
	AppendLine(String)	Fügt eine Kopie der angegebenen Zeichenfolge gefolgt vom Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.
	Clear	Entfernt alle Zeichen aus der aktuellen StringBuilder-Instanz.
	CopyTo	Kopiert die Zeichen aus einem angegebenen Segment dieser Instanz in ein angegebenes Segment eines Ziel-Char-Arrays.
	EnsureCapacity	Stellt sicher, dass die Kapazität dieser Instanz von StringBuilder mindestens gleich dem angegebenen Wert ist.
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Equals(StringBuilder)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	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 der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Char)	Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichens an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Char[])	Fügt die Zeichenfolgendarstellung eines angegebenen Arrays von Unicode-Zeichen 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 der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Int16)	Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Int64)	Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz 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-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Single)	Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, String)	Fügt eine Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, UInt16)	Fügt die Zeichenfolgendarstellung einer 16-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, UInt32)	Fügt die Zeichenfolgendarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, UInt64)	Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, String, Int32)	Fügt eine oder mehrere Kopien einer angegebenen Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.
	Insert(Int32, Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an der angegebenen Zeichenposition in diese Instanz ein.
	Remove	Entfernt den angegebenen Bereich von Zeichen aus dieser Instanz.
	Replace(Char, Char)	Ersetzt in dieser Instanz alle Vorkommen eines angegebenen Zeichens durch ein anderes angegebenes Zeichen.
	Replace(String, String)	Ersetzt in dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge.
	Replace(Char, Char, Int32, Int32)	Ersetzt alle Vorkommen eines angegebenen Zeichens in einer Teilzeichenfolge dieser Instanz durch ein anderes angegebenes Zeichen.
	Replace(String, String, Int32, Int32)	Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in einer Teilzeichenfolge dieser Instanz durch eine andere angegebene Zeichenfolge.
	ToString()	Konvertiert den Wert dieser Instanz in einen String. (Überschreibt Object.ToString().)
	ToString(Int32, Int32)	Konvertiert den Wert einer Teilzeichenfolge dieser Instanz in eine String.

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	ISerializable.GetObjectData	Infrastruktur. Füllt ein System.Runtime.Serialization.SerializationInfo-Objekt mit den Daten auf, die zum Deserialisieren des aktuellen StringBuilder-Objekts erforderlich sind.

Zum Seitenanfang

Hinweise

Diese Klasse stellt ein zeichenfolgenähnliches Objekt dar, dessen Wert eine veränderbare Zeichensequenz ist. Der Wert wird geändert, da er nach Erstellung geändert werden kann, indem angefügt wird, entfernt, ersetzt, einfügt oder Zeichen. Sehen Sie im Vergleich dazu die String-Klasse.

Die meisten Methoden, die eine Instanz dieser Klassenrückgabe ein Verweis auf der gleichen Instanz ändern und eine Methode oder eine Eigenschaft im Verweis aufrufen. Dies kann nützlich sein, wenn Sie eine einzelne Anweisung schreiben möchten, die aufeinander folgende Vorgänge verkettet.

Die Kapazität einer StringBuilder-Instanz ist die maximale Anzahl von Zeichen, die die Instanz zu einem beliebigen Zeitpunkt speichern kann. Die Kapazität ist größer als oder gleich, die Länge der Zeichenfolgendarstellung des Werts der Instanz. Die Kapazität kann mit der Capacity-Eigenschaft oder der EnsureCapacity-Methode vergrößert bzw. verkleinert werden. Sie darf jedoch den Wert der Length-Eigenschaft nicht unterschreiten.

Wenn Sie nicht die Kapazität oder die maximale Kapazität angeben, wenn Sie eine Instanz von StringBuilder initialisieren, werden implementierungsabhängige Standardwerte verwendet. Weitere Informationen finden Sie im Abschnitt Speicherbelegung.

StringBuilder-Funktionalität

Die aktuelle Größe eines Objekts StringBuilder wird durch seine Length-Eigenschaft definiert. Sie können auf die Zeichen im Wert eines - Objekts StringBuilder zugreifen, indem Sie die - Eigenschaft Chars verwenden. Die Indexpositionen beginnen bei 0 (null).

Die StringBuilder-Klasse umfasst Methoden, die die Größe der aktuellen Instanz reduzieren können. Die Clear-Methode entfernt alle Zeichen und stellt die Length-Eigenschaft auf Null. Die Remove-Methode löscht einen Zeichenbereich.

Die StringBuilder-Klasse umfasst auch Methoden, die aktuelle Instanz erweitern können. Die Append und AppendLine-Methoden fügen Daten dem Ende des StringBuilder-Objekts hinzu, und die Insert-Methodeneinfügungsdaten in einer angegebenen Zeichenposition in aktuellen StringBuilder ein Objekt. Die AppendFormat-Methode verwendet die - Funktion, um kombinierte Formatierung formatierten Text am Ende eines - Objekts StringBuilder hinzuzufügen.

Die Replace-Methode ersetzt alle Vorkommen eines Zeichens oder einer Zeichenfolge im gesamten StringBuilder-Objekt oder in einem bestimmten Zeichenbereich.

Sie müssen das StringBuilder-Objekt in ein String-Objekt konvertieren, bevor Sie die vom StringBuilder-Objekt dargestellte Zeichenfolge an eine Methode übergeben können, die einen String-Parameter aufweist, oder bevor Sie sie auf der Benutzeroberfläche anzeigen. Sie führen diese Konvertierung aus, indem Sie die ToString-Methode aufrufen.

Überlegungen zur Leistung

Bei einem String-Objektverkettungsvorgang wird immer ein neues Objekt aus der bestehenden Zeichenfolge und den neuen Daten erstellt. Ein StringBuilder-Objekt verwaltetet einen Puffer, um die Verkettung von neuen Daten aufzunehmen. Neue Daten werden dem Puffer angefügt, wenn Zimmer frei ist; Andernfalls wird ein neuer, größerer Puffer zugeordnet, werden Daten aus dem ursprünglichen Puffer zum neuen Puffer kopiert, und die neuen Daten werden dann zum neuen Puffer angefügt.

Die Leistung eines Verkettungsvorgangs für ein String oder StringBuilder-Objekt hängt von der Häufigkeit der Speicherbelegungen ab. Ein String Verkettungsvorgang immer Speicher belegt, während ein StringBuilder Verkettungsvorgang Speicher belegt, nur bei der StringBuilder-Objektpuffer zu klein ist, die neuen Daten angepasst. Verwenden Sie die String-Klasse, wenn eine feste Anzahl String-Objekten verketten. In diesem Fall kombiniert der Compiler möglicherweise sogar einzelne Verkettungsvorgänge in einen einzelnen Vorgang. Verwenden Sie ein - Objekt StringBuilder, wenn Sie eine beliebige Anzahl von Zeichenfolgen verketten, Wenn Sie beispielsweise eine - Schleife verwenden, um ein Zufallszahlen von Zeichenfolgen der Benutzereingabe zu verketten.

Speicherbelegung

Die Standardkapazität für diese Implementierung ist 16, und der Standardwert für die maximale Kapazität ist Int32.MaxValue.

Ein - Objekt StringBuilder kann mehr Arbeitsspeicher zu den Speicherzeichen zuordnen, wenn der Wert einer Instanz vergrößert wird und die Kapazität entsprechend angepasst wird. Beispielsweise können die Append-Methode, die AppendFormat-Methode, die EnsureCapacity-Methode, die Insert-Methode und die Replace-Methode den Wert einer Instanz vergrößern.

Der Speicher, der zugeordnet ist, ist implementierungsabhängig, und eine Ausnahme (entweder ArgumentOutOfRangeException oder OutOfMemoryException) wird ausgelöst, wenn der Arbeitsspeicher, der erforderlich ist, größer als die maximale Kapazität ist.

Hinweise zu Aufrufern

In .NET Framework 4 und in .NET Framework 4.5 wenn Sie das StringBuilder-Objekt instanziieren, indem Sie den StringBuilder(Int32, Int32)-Konstruktor, aufrufen, können die Länge und die Kapazität der StringBuilder-Instanz über dem Wert der - Eigenschaft MaxCapacity hinaus wachsen. Dies kann auftreten, wenn Sie die Append und AppendFormat-Methoden aufrufen, um kleine Zeichenfolgen anzufügen.

Beispiele

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

C++


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

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Text-Namespace

String

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)