StringBuilder.Append StringBuilder.Append StringBuilder.Append StringBuilder.Append Method

Definition

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.Appends the string representation of a specified object to this instance.

Überlädt

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)

Fügt die Zeichenfolgendarstellung eines angegebenen Zeichenfolgengenerators an diese Instanz an.Appends the string representation of a specified string builder to this instance.

Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 16-bit unsigned integer to this instance.

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 32-bit unsigned integer to this instance.

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 64-bit unsigned integer to this instance.

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an diese Instanz an.Appends the string representation of a specified subarray of Unicode characters to this instance.

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

Fügt ein Array aus Unicode-Zeichen ab einer angegebenen Adresse an diese Instanz an.Appends an array of Unicode characters starting at a specified address to this instance.

Append(String) Append(String) Append(String) Append(String)

Fügt eine Kopie der angegebenen Zeichenfolge an diese Instanz an.Appends a copy of the specified string to this instance.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Fügt eine Kopie einer angegebenen Teilzeichenfolge an diese Instanz an.Appends a copy of a specified substring to this instance.

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)

Fügt eine Kopie einer Teilzeichenfolge im festgelegten Zeichenfolgengenerator an diese Instanz an.Appends a copy of a substring within a specified string builder to this instance.

Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Fügt eine angegebene Anzahl von Kopien der Zeichenfolgendarstellung eines Unicode-Zeichens an diese Instanz an.Appends a specified number of copies of the string representation of a Unicode character to this instance.

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 8-bit signed integer to this instance.

Append(Single) Append(Single) Append(Single) Append(Single)

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit an diese Instanz an.Appends the string representation of a specified single-precision floating-point number to this instance.

Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>)

Fügt die Zeichenfolgendarstellung eines festgelegten schreibgeschützten Zeichenspeicherbereichs an diese Instanz an.Appends the string representation of a specified read-only character memory region to this instance.

Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

Fügt die Zeichenfolgendarstellung eines angegebenen booleschen Werts an diese Instanz an.Appends the string representation of a specified Boolean value to this instance.

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)

Fügt die Zeichenfolgendarstellung einer festgelegten schreibgeschützten Zeichenspanne an diese Instanz an.Appends the string representation of a specified read-only character span to this instance.

Append(Char) Append(Char) Append(Char) Append(Char)

Fügt die Zeichenfolgendarstellung eines angegebenen Char-Objekts an diese Instanz an.Appends the string representation of a specified Char object to this instance.

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array an diese Instanz an.Appends the string representation of the Unicode characters in a specified array to this instance.

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

Fügt die Zeichenfolgendarstellung einer angegebenen Dezimalzahl an diese Instanz an.Appends the string representation of a specified decimal number to this instance.

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 8-bit unsigned integer to this instance.

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 16-bit signed integer to this instance.

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 32-bit signed integer to this instance.

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 64-bit signed integer to this instance.

Append(Object) Append(Object) Append(Object) Append(Object)

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.Appends the string representation of a specified object to this instance.

Append(Double) Append(Double) Append(Double) Append(Double)

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit doppelter Genauigkeit an diese Instanz an.Appends the string representation of a specified double-precision floating-point number to this instance.

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)

Fügt die Zeichenfolgendarstellung eines angegebenen Zeichenfolgengenerators an diese Instanz an.Appends the string representation of a specified string builder to this instance.

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 StringBuilder StringBuilder StringBuilder

Der anzufügende Zeichenfolgengenerator.The string builder to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation is completed.

Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 16-bit unsigned integer to this instance.

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

Parameter

value
UInt16 UInt16 UInt16 UInt16

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(UInt16) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(UInt16) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 UInt16.ToString(IFormatProvider) die-Methode auf, um die valueZeichen folgen Darstellung von zu erhalten.The Append(UInt16) method calls the UInt16.ToString(IFormatProvider) method to get the string representation of value. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 32-bit unsigned integer to this instance.

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

Parameter

value
UInt32 UInt32 UInt32 UInt32

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(UInt32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(UInt32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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

Die Append(UInt32) Ruft die UInt32.ToString -Methode auf, um die Zeichen value folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(UInt32) calls the UInt32.ToString method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 64-bit unsigned integer to this instance.

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

Parameter

value
UInt64 UInt64 UInt64 UInt64

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(UInt64) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(UInt64) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 UInt64.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(UInt64) method calls the UInt64.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an diese Instanz an.Appends the string representation of a specified subarray of Unicode characters to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <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.A character array.

startIndex
Int32 Int32 Int32 Int32

Die Anfangsposition in value.The starting position in value.

charCount
Int32 Int32 Int32 Int32

Die Anzahl der anzufügenden Zeichen.The number of characters to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

value ist null, und startIndex und charCount sind nicht 0 (null).value is null, and startIndex and charCount are not zero.

charCount ist kleiner als Null.charCount is less than zero.

- oder --or- startIndex ist kleiner als Null.startIndex is less than zero.

- oder --or- startIndex + charCount ist größer als die Länge von value.startIndex + charCount is greater than the length of value.

- oder --or- Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Diese Methode fügt den angegebenen Bereich von Zeichen value an die aktuelle Instanz an.This method appends the specified range of characters in value to the current instance. Wenn valuegleich undstartIndex und gleichcount NULL sind, werden keine Änderungen vorgenommen. nullIf value is null and startIndex and count are both zero, no changes are made.

Die Append(Char[], Int32, Int32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Char[], Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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.
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 dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

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.Appends an array of Unicode characters starting at a specified address to this instance.

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

Parameter

value
Char*

Ein Zeiger auf ein Array von Zeichen.A pointer to an array of characters.

valueCount
Int32 Int32 Int32 Int32

Die Anzahl der Zeichen im Array.The number of characters in the array.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

valueCount ist kleiner als Null.valueCount is less than zero.

- oder --or- Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Diese Methode fügt valueCount an der aktuellen Instanz beginnende Zeichen an die Adresse value an.This method appends valueCount characters starting at address value to the current instance.

Die Append(Char*, Int32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Char*, Int32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder eine Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen dem- StringBuilder Objekt den Rückgabewert nicht zuweisen.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(String) Append(String) Append(String) Append(String)

Fügt eine Kopie der angegebenen Zeichenfolge an diese Instanz an.Appends a copy of the specified string to this instance.

public:
 System::Text::StringBuilder ^ Append(System::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 String String String

Die anzufügende Zeichenfolge.The string to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(String) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(String) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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.
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 valueden Wert hat,werdenkeineÄnderungenvorgenommen.nullIf value is null, no changes are made.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Fügt eine Kopie einer angegebenen Teilzeichenfolge an diese Instanz an.Appends a copy of a specified substring to this instance.

public:
 System::Text::StringBuilder ^ Append(System::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 String String String

Die Zeichenfolge, die die anzufügende Teilzeichenfolge enthält.The string that contains the substring to append.

startIndex
Int32 Int32 Int32 Int32

Die Anfangsposition der Teilzeichenfolge innerhalb des value-Parameters.The starting position of the substring within value.

count
Int32 Int32 Int32 Int32

Die Anzahl der anzufügenden Zeichen in value.The number of characters in value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

value ist null, und startIndex und count sind nicht 0 (null).value is null, and startIndex and count are not zero.

count ist kleiner als 0 (null).count less than zero.

- oder --or- startIndex ist kleiner als 0 (null).startIndex less than zero.

- oder --or- startIndex + count ist größer als die Länge von value.startIndex + count is greater than the length of value.

- oder --or- Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Diese Methode fügt den angegebenen Bereich von Zeichen value an die aktuelle Instanz an.This method appends the specified range of characters in value to the current instance. Wenn valuegleich undstartIndex und gleichcount NULL sind, werden keine Änderungen vorgenommen. nullIf value is null and startIndex and count are both zero, no changes are made.

Die Append(String, Int32, Int32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(String, Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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      
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 dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)

Fügt eine Kopie einer Teilzeichenfolge im festgelegten Zeichenfolgengenerator an diese Instanz an.Appends a copy of a substring within a specified string builder to this instance.

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 StringBuilder StringBuilder StringBuilder

Der Zeichenfolgengenerator, der die anzufügende Teilzeichenfolge enthält.The string builder that contains the substring to append.

startIndex
Int32 Int32 Int32 Int32

Die Anfangsposition der Teilzeichenfolge innerhalb des value-Parameters.The starting position of the substring within value.

count
Int32 Int32 Int32 Int32

Die Anzahl der anzufügenden Zeichen in value.The number of characters in value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Fügt eine angegebene Anzahl von Kopien der Zeichenfolgendarstellung eines Unicode-Zeichens an diese Instanz an.Appends a specified number of copies of the string representation of a Unicode character to this instance.

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 Char Char Char

Das anzufügende Zeichen.The character to append.

repeatCount
Int32 Int32 Int32 Int32

Die Anzahl der Anfügewiederholungen für value.The number of times to append value.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

repeatCount ist kleiner als Null.repeatCount is less than zero.

- oder --or- Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Char, Int32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Char, Int32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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*****
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 dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 8-bit signed integer to this instance.

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

Parameter

value
SByte SByte SByte SByte

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(SByte) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(SByte) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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 
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 SByte.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(SByte) method calls the SByte.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Single) Append(Single) Append(Single) Append(Single)

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit einfacher Genauigkeit an diese Instanz an.Appends the string representation of a specified single-precision floating-point number to this instance.

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 Single Single Single

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Single) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Single) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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*****
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 Single.ToString die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Single) method calls the Single.ToString method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>)

Fügt die Zeichenfolgendarstellung eines festgelegten schreibgeschützten Zeichenspeicherbereichs an diese Instanz an.Appends the string representation of a specified read-only character memory region to this instance.

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.The read-only character memory region to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation is completed.

Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

Fügt die Zeichenfolgendarstellung eines angegebenen booleschen Werts an diese Instanz an.Appends the string representation of a specified Boolean value to this instance.

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 Boolean Boolean Boolean

Der anzufügende boolesche Wert.The Boolean value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Boolean) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Boolean) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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.
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 Boolean.ToString() die-Methode auf, um die valueZeichen folgen Darstellung von zu erhalten.The Append(Boolean) method calls the Boolean.ToString() method to get the string representation of value. Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)

Fügt die Zeichenfolgendarstellung einer festgelegten schreibgeschützten Zeichenspanne an diese Instanz an.Appends the string representation of a specified read-only character span to this instance.

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.The read-only character span to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation is completed.

Append(Char) Append(Char) Append(Char) Append(Char)

Fügt die Zeichenfolgendarstellung eines angegebenen Char-Objekts an diese Instanz an.Appends the string representation of a specified Char object to this instance.

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 Char Char Char

Die anzufügende UTF-16-codierte Codeeinheit.The UTF-16-encoded code unit to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Char) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Char) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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'  '.'      
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 dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

Fügt die Zeichenfolgendarstellung der Unicode-Zeichen in einem angegebenen Array an diese Instanz an.Appends the string representation of the Unicode characters in a specified array to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <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.The array of characters to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Diese Methode fügt alle Zeichen im angegebenen Array an die aktuelle Instanz in derselben Reihenfolge an, in der Sie angezeigt valuewerden.This method appends all the characters in the specified array to the current instance in the same order as they appear in value. Wenn valueden Wert hat,werdenkeineÄnderungenvorgenommen.nullIf value is null, no changes are made.

Die Append(Char[]) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Char[]) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

Fügt die Zeichenfolgendarstellung einer angegebenen Dezimalzahl an diese Instanz an.Appends the string representation of a specified decimal number to this instance.

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 Decimal Decimal Decimal

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Decimal) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Decimal) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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*****
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 Decimal.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Decimal) method calls the Decimal.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen an diese Instanz an.Appends the string representation of a specified 8-bit unsigned integer to this instance.

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 Byte Byte Byte

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Byte) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Byte) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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      
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 ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Byte) method calls the ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 16-bit signed integer to this instance.

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 Int16 Int16 Int16

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Int16) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Int16) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 Int16.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Int16) method calls the Int16.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 32-bit signed integer to this instance.

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 Int32 Int32 Int32

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Int32) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Int32) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 Int32.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Int32) method calls the Int32.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

Fügt die Zeichenfolgendarstellung einer angegebenen 64-Bit-Ganzzahl mit Vorzeichen an diese Instanz an.Appends the string representation of a specified 64-bit signed integer to this instance.

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 Int64 Int64 Int64

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Int64) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Int64) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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
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 Int64.ToString(IFormatProvider) den auf, um die Zeichen value folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Int64) method calls the Int64.ToString(IFormatProvider) to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Object) Append(Object) Append(Object) Append(Object)

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an diese Instanz an.Appends the string representation of a specified object to this instance.

public:
 System::Text::StringBuilder ^ Append(System::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 Object Object Object

Das anzufügende Objekt.The object to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Object) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Object) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates. Es definiert eine Dog -Klasse, erstellt Dog ein-Objekt und führt drei Aufrufe an Append die-Methode aus, um eine Zeichenfolge zu erstellen, die den Namen und die Rasse des Hundes enthält.It defines a Dog class, creates a Dog object, and makes three calls to the Append method to create a string that contains the dog's name and breed.

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
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 Object.ToString die-Methode auf, um die valueZeichen folgen Darstellung von zu erhalten.The Append(Object) method calls the Object.ToString method to get the string representation of value. Wenn valueden Wert StringBuilder hat, werden keine Änderungen am-Objekt vorgenommen. nullIf value is null, no changes are made to the StringBuilder object.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Append(Double) Append(Double) Append(Double) Append(Double)

Fügt die Zeichenfolgendarstellung einer angegebenen Gleitkommazahl mit doppelter Genauigkeit an diese Instanz an.Appends the string representation of a specified double-precision floating-point number to this instance.

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 Double Double Double

Der anzufügende Wert.The value to append.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.A reference to this instance after the append operation has completed.

Ausnahmen

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.Enlarging the value of this instance would exceed MaxCapacity.

Hinweise

Die Append(Double) -Methode ändert die vorhandene Instanz dieser Klasse; Sie gibt keine neue Klasseninstanz zurück.The Append(Double) method modifies the existing instance of this class; it does not return a new class instance. Aus diesem Grund können Sie eine Methode oder Eigenschaft für den vorhandenen Verweis aufzurufen, und Sie müssen den Rückgabewert nicht einem StringBuilder -Objekt zuweisen, wie im folgenden Beispiel veranschaulicht.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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*****
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 Double.ToString(IFormatProvider) die-Methode auf, um die value Zeichen folgen Darstellung von für die aktuelle Kultur zu erhalten.The Append(Double) method calls the Double.ToString(IFormatProvider) method to get the string representation of value for the current culture. Um die Formatierung von valuezu steuern, wird die AppendFormat -Methode aufgerufen.To control the formatting of value, call the AppendFormat method.

Die Kapazität dieser Instanz wird nach Bedarf angepasst.The capacity of this instance is adjusted as needed.

Hinweise für Aufrufer

Wenn Sie in .net Core und in den .NET Framework 4,0 und höheren Versionen StringBuilder das Objekt durch Aufrufen des StringBuilder(Int32, Int32) Konstruktors instanziieren, können sowohl die Länge StringBuilder als auch die Kapazität der MaxCapacity Instanz über den Wert des Property.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Dies kann besonders dann der Fall sein, Append(String) Wenn AppendFormat(String, Object) Sie die Methoden und zum Anfügen kleiner Zeichen folgen aufzurufen.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Siehe auch

Gilt für: