Teilen über


StringBuilder.Append Methode

Definition

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.

Überlädt

Append(StringBuilder)

Fügt die Zeichenfolgendarstellung eines angegebenen Zeichenfolgengenerators an diese Instanz an.

Append(StringBuilder+AppendInterpolatedStringHandler)

Fügt die angegebene interpolierte Zeichenfolge an diese instance 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(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(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Fügt die angegebene interpolierte Zeichenfolge mit dem angegebenen Format an diese instance an.

Append(String)

Fügt eine Kopie der angegebenen Zeichenfolge an diese Instanz an.

Append(String, Int32, Int32)

Fügt eine Kopie einer angegebenen Teilzeichenfolge an diese Instanz an.

Append(StringBuilder, Int32, Int32)

Fügt eine Kopie einer Teilzeichenfolge im festgelegten Zeichenfolgengenerator an diese Instanz an.

Append(Char*, Int32)

Fügt ein Array aus Unicode-Zeichen ab einer angegebenen Adresse an diese Instanz an.

Append(Single)

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit an diese Instanz an.

Append(UInt64)

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.

Append(ReadOnlySpan<Char>)

Fügt die Zeichenfolgendarstellung einer festgelegten schreibgeschützten Zeichenspanne an diese Instanz an.

Append(SByte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.

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 Char-Objekts 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(Char[])

Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array 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(ReadOnlyMemory<Char>)

Fügt die Zeichenfolgendarstellung eines festgelegten schreibgeschützten Zeichenspeicherbereichs an diese Instanz an.

Append(StringBuilder)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Zeichenfolgengenerators an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);
member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder
Public Function Append (value As StringBuilder) As StringBuilder

Parameter

value
StringBuilder

Der anzufügende Zeichenfolgengenerator.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für:

Append(StringBuilder+AppendInterpolatedStringHandler)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die angegebene interpolierte Zeichenfolge an diese instance an.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

handler
StringBuilder.AppendInterpolatedStringHandler

Die interpolierte Zeichenfolge, die angefügt werden soll.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für:

Append(UInt16)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);
[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder
Public Function Append (value As UShort) As StringBuilder

Parameter

value
UInt16

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(UInt16) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

Die Append(UInt16) -Methode ruft die UInt16.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von valueabzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(UInt32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);
[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder
Public Function Append (value As UInteger) As StringBuilder

Parameter

value
UInt32

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(UInt32) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

Ruft Append(UInt32) die UInt32.ToString -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Char, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine angegebene Anzahl von Kopien der Zeichenfolgendarstellung eines Unicode-Zeichens an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);
public System.Text.StringBuilder Append (char value, int repeatCount);
member this.Append : char * int -> System.Text.StringBuilder
Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Parameter

value
Char

Das anzufügende Zeichen.

repeatCount
Int32

Die Anzahl der Anfügewiederholungen für value.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

repeatCount ist kleiner als Null.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Nicht genügend Arbeitsspeicher.

Hinweise

Die Append(Char, Int32) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****$1,346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****$1,346.19*****

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Char[], Int32, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[]? value, int startIndex, int charCount);
member this.Append : char[] * int * int -> System.Text.StringBuilder
Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Parameter

value
Char[]

Ein Zeichenarray.

startIndex
Int32

Die Anfangsposition in value.

charCount
Int32

Die Anzahl der anzufügenden Zeichen.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

value ist null, und startIndex und charCount sind nicht 0 (null).

charCount ist kleiner als Null.

- oder -

startIndex ist kleiner als Null.

- oder -

startIndex + charCount ist größer als die Länge von value.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Diese Methode fügt den angegebenen Zeichenbereich an value den aktuellen instance an. null Wenn value und startIndex beide count null sind, werden keine Änderungen vorgenommen.

Die Append(Char[], Int32, Int32) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{sb}"
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' The example displays the following output:
'       The array from positions 0 to 2 contains abc.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die angegebene interpolierte Zeichenfolge mit dem angegebenen Format an diese instance an.

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

handler
StringBuilder.AppendInterpolatedStringHandler

Die interpolierte Zeichenfolge, die angefügt werden soll.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für:

Append(String)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine Kopie der angegebenen Zeichenfolge an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (string value);
public System.Text.StringBuilder Append (string? value);
member this.Append : string -> System.Text.StringBuilder
Public Function Append (value As String) As StringBuilder

Parameter

value
String

Die anzufügende Zeichenfolge.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(String) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Wenn value ist null, werden keine Änderungen vorgenommen.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(String, Int32, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine Kopie einer angegebenen Teilzeichenfolge an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (string value, int startIndex, int count);
public System.Text.StringBuilder Append (string? value, int startIndex, int count);
member this.Append : string * int * int -> System.Text.StringBuilder
Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

Parameter

value
String

Die Zeichenfolge, die die anzufügende Teilzeichenfolge enthält.

startIndex
Int32

Die Anfangsposition der Teilzeichenfolge innerhalb des value-Parameters.

count
Int32

Die Anzahl der anzufügenden Zeichen in value.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

value ist null, und startIndex und count sind nicht 0 (null).

count ist kleiner als 0 (null).

- oder -

startIndex ist kleiner als 0 (null).

- oder -

startIndex + count ist größer als die Länge von value.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Diese Methode fügt den angegebenen Zeichenbereich an value den aktuellen instance an. null Wenn value und startIndex beide count null sind, werden keine Änderungen vorgenommen.

Die Append(String, Int32, Int32) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797
let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{sb}"
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797
Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(" to ")
index += length + 1
sb.Append(str, index, str.Length - index)
Console.WriteLine(sb)
' The example displays the following output:
'    First President of the United States: George Washington, from 1789 to 1797

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(StringBuilder, Int32, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine Kopie einer Teilzeichenfolge im festgelegten Zeichenfolgengenerator an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);
member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder
Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

Parameter

value
StringBuilder

Der Zeichenfolgengenerator, der die anzufügende Teilzeichenfolge enthält.

startIndex
Int32

Die Anfangsposition der Teilzeichenfolge innerhalb des value-Parameters.

count
Int32

Die Anzahl der anzufügenden Zeichen in value.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für:

Append(Char*, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Fügt ein Array aus Unicode-Zeichen ab einer angegebenen Adresse an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Parameter

value
Char*

Ein Zeiger auf ein Array von Zeichen.

valueCount
Int32

Die Anzahl der Zeichen im Array.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

valueCount ist kleiner als Null.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

value ist ein NULL-Zeiger

Hinweise

Diese Methode fügt Zeichen ab Adresse value an den aktuellen instance anvalueCount.

Die Append(Char*, Int32) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Gilt für:

Append(Single)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(float value);
public System.Text.StringBuilder Append (float value);
member this.Append : single -> System.Text.StringBuilder
Public Function Append (value As Single) As StringBuilder

Parameter

value
Single

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Single) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

Die Append(Single) -Methode ruft die Single.ToString -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(UInt64)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);
[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder
Public Function Append (value As ULong) As StringBuilder

Parameter

value
UInt64

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(UInt64) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

Die Append(UInt64) -Methode ruft die UInt64.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(ReadOnlySpan<Char>)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer festgelegten schreibgeschützten Zeichenspanne an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);
public System.Text.StringBuilder Append (ReadOnlySpan<char> value);
member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

Parameter

value
ReadOnlySpan<Char>

Die anzufügende schreibgeschützte Zeichenspanne.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für:

Append(SByte)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);
[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder
Public Function Append (value As SByte) As StringBuilder

Parameter

value
SByte

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(SByte) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127

Die Append(SByte) -Methode ruft die SByte.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Boolean)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen booleschen Werts an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(bool value);
public System.Text.StringBuilder Append (bool value);
member this.Append : bool -> System.Text.StringBuilder
Public Function Append (value As Boolean) As StringBuilder

Parameter

value
Boolean

Der anzufügende boolesche Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Boolean) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Die Append(Boolean) -Methode ruft die Boolean.ToString() -Methode auf, um die Zeichenfolgendarstellung von valueabzurufen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Byte)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::Byte value);
public System.Text.StringBuilder Append (byte value);
member this.Append : byte -> System.Text.StringBuilder
Public Function Append (value As Byte) As StringBuilder

Parameter

value
Byte

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Byte) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253
let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// The example displays the following output:
//         The byte array: 16 132 27 253
Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253

Die Append(Byte) -Methode ruft die ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Char)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Char-Objekts an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(char value);
public System.Text.StringBuilder Append (char value);
member this.Append : char -> System.Text.StringBuilder
Public Function Append (value As Char) As StringBuilder

Parameter

value
Char

Die anzufügende UTF-16-codierte Codeeinheit.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Char) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'
let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {sb}"
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'
Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Decimal)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen Dezimalzahl an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);
public System.Text.StringBuilder Append (decimal value);
member this.Append : decimal -> System.Text.StringBuilder
Public Function Append (value As Decimal) As StringBuilder

Parameter

value
Decimal

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Decimal) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

Die Append(Decimal) -Methode ruft die Decimal.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Double)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit doppelter Genauigkeit an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(double value);
public System.Text.StringBuilder Append (double value);
member this.Append : double -> System.Text.StringBuilder
Public Function Append (value As Double) As StringBuilder

Parameter

value
Double

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Double) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

Die Append(Double) -Methode ruft die Double.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Char[])

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
public System.Text.StringBuilder Append (char[] value);
public System.Text.StringBuilder Append (char[]? value);
member this.Append : char[] -> System.Text.StringBuilder
Public Function Append (value As Char()) As StringBuilder

Parameter

value
Char[]

Das anzufügende Array von Zeichen.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Diese Methode fügt alle Zeichen im angegebenen Array in derselben Reihenfolge an die aktuelle instance an, in der sie in valueangezeigt werden. Wenn value ist null, werden keine Änderungen vorgenommen.

Die Append(Char[]) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

char[] chars = { 'a', 'e', 'i', 'o', 'u' };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The characters in the array: ").Append(chars);
Console.WriteLine(sb);
// The example displays the following output:
//      The characters in the array: aeiou
let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{sb}"
// The example displays the following output:
//      The characters in the array: aeiou
Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c }
Dim sb As New System.Text.StringBuilder()
sb.Append("The characters in the array: ").Append(chars)
Console.WriteLine(sb)
' The example displays the following output:
'      The characters in the array: aeiou

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Gilt für:

Append(Int16)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(short value);
public System.Text.StringBuilder Append (short value);
member this.Append : int16 -> System.Text.StringBuilder
Public Function Append (value As Short) As StringBuilder

Parameter

value
Int16

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Int16) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

Die Append(Int16) -Methode ruft die Int16.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(int value);
public System.Text.StringBuilder Append (int value);
member this.Append : int -> System.Text.StringBuilder
Public Function Append (value As Integer) As StringBuilder

Parameter

value
Int32

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Int32) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

Die Append(Int32) -Methode ruft die Int32.ToString(IFormatProvider) -Methode auf, um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Int64)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(long value);
public System.Text.StringBuilder Append (long value);
member this.Append : int64 -> System.Text.StringBuilder
Public Function Append (value As Long) As StringBuilder

Parameter

value
Int64

Der anzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Int64) -Methode ändert die vorhandene instance dieser Klasse. Sie gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

Die Append(Int64) -Methode ruft auf Int64.ToString(IFormatProvider) , um die Zeichenfolgendarstellung von value für die aktuelle Kultur abzurufen. Rufen Sie die -Methode auf, um die AppendFormat Formatierung von valuezu steuern.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(Object)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (object value);
public System.Text.StringBuilder Append (object? value);
member this.Append : obj -> System.Text.StringBuilder
Public Function Append (value As Object) As StringBuilder

Parameter

value
Object

Das anzufügende Objekt.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Die Append(Object) -Methode ändert die vorhandene instance dieser Klasse und gibt keine neue Klasse instance zurück. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufrufen, und Sie müssen den Rückgabewert nicht einem StringBuilder Objekt zuweisen, wie das folgende Beispiel veranschaulicht. Sie definiert eine Dog Klasse, erstellt ein Dog -Objekt und führt drei Aufrufe an die Append -Methode aus, um eine Zeichenfolge zu erstellen, die den Namen und die Rasse des Hundes enthält.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

Die Append(Object) -Methode ruft die Object.ToString -Methode auf, um die Zeichenfolgendarstellung von valueabzurufen. Wenn value ist null, werden keine Änderungen am StringBuilder -Objekt vorgenommen.

Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance über den Wert seiner MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

Append(ReadOnlyMemory<Char>)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines festgelegten schreibgeschützten Zeichenspeicherbereichs an diese Instanz an.

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);
public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);
member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Parameter

value
ReadOnlyMemory<Char>

Der anzufügende schreibgeschützte Zeichenspeicherbereich.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Gilt für: