StringBuilder.Append Method

Definition

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.Appends the string representation of a specified object to this instance.

Overloads

Append(StringBuilder)

Accoda la rappresentazione stringa di un generatore di stringhe specificato a questa istanza.Appends the string representation of a specified string builder to this instance.

Append(UInt16)

Accoda la rappresentazione di stringa di un intero senza segno a 16 bit specificato a questa istanza.Appends the string representation of a specified 16-bit unsigned integer to this instance.

Append(UInt32)

Accoda la rappresentazione di stringa di un intero senza segno a 32 bit specificato a questa istanza.Appends the string representation of a specified 32-bit unsigned integer to this instance.

Append(UInt64)

Accoda la rappresentazione di stringa di un intero senza segno a 64 bit specificato a questa istanza.Appends the string representation of a specified 64-bit unsigned integer to this instance.

Append(Char[], Int32, Int32)

Accoda la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode a questa istanza.Appends the string representation of a specified subarray of Unicode characters to this instance.

Append(Char*, Int32)

Accoda a questa istanza una matrice di caratteri Unicode a partire da un indirizzo specificato.Appends an array of Unicode characters starting at a specified address to this instance.

Append(String)

Accoda una copia della stringa specificata a questa istanza.Appends a copy of the specified string to this instance.

Append(String, Int32, Int32)

Accoda una copia della sottostringa specificata a questa istanza.Appends a copy of a specified substring to this instance.

Append(StringBuilder, Int32, Int32)

Accoda a questa istanza una copia di una sottostringa all'interno di un generatore di stringhe specificato.Appends a copy of a substring within a specified string builder to this instance.

Append(Char, Int32)

Accoda un numero specificato di copie della rappresentazione di stringa di un carattere Unicode a questa istanza.Appends a specified number of copies of the string representation of a Unicode character to this instance.

Append(SByte)

Accoda la rappresentazione di stringa di un intero con segno a 8 bit specificato a questa istanza.Appends the string representation of a specified 8-bit signed integer to this instance.

Append(Single)

Accoda la rappresentazione di stringa di un numero a virgola mobile a precisione singola specificato a questa istanza.Appends the string representation of a specified single-precision floating-point number to this instance.

Append(ReadOnlyMemory<Char>)

Accoda a questa istanza la rappresentazione stringa di un'area di memoria dei caratteri di sola lettura specificata.Appends the string representation of a specified read-only character memory region to this instance.

Append(Boolean)

Accoda la rappresentazione di stringa di un valore booleano specificato a questa istanza.Appends the string representation of a specified Boolean value to this instance.

Append(ReadOnlySpan<Char>)

Accoda a questa istanza la rappresentazione stringa di un intervallo di caratteri di sola lettura specificato.Appends the string representation of a specified read-only character span to this instance.

Append(Char)

Accoda la rappresentazione di stringa di un oggetto Char specificato a questa istanza.Appends the string representation of a specified Char object to this instance.

Append(Char[])

Accoda la rappresentazione di stringa dei caratteri Unicode in una matrice specificata a questa istanza.Appends the string representation of the Unicode characters in a specified array to this instance.

Append(Decimal)

Accoda la rappresentazione di stringa di un numero decimale specificato a questa istanza.Appends the string representation of a specified decimal number to this instance.

Append(Byte)

Accoda la rappresentazione di stringa di un intero senza segno a 8 bit specificato a questa istanza.Appends the string representation of a specified 8-bit unsigned integer to this instance.

Append(Int16)

Accoda la rappresentazione di stringa di un intero con segno a 16 bit specificato a questa istanza.Appends the string representation of a specified 16-bit signed integer to this instance.

Append(Int32)

Accoda la rappresentazione di stringa di un intero con segno a 32 bit specificato a questa istanza.Appends the string representation of a specified 32-bit signed integer to this instance.

Append(Int64)

Accoda la rappresentazione di stringa di un intero con segno a 64 bit specificato a questa istanza.Appends the string representation of a specified 64-bit signed integer to this instance.

Append(Object)

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.Appends the string representation of a specified object to this instance.

Append(Double)

Accoda la rappresentazione di stringa di un numero a virgola mobile e precisione doppia specificato a questa istanza.Appends the string representation of a specified double-precision floating-point number to this instance.

Append(StringBuilder)

Accoda la rappresentazione stringa di un generatore di stringhe specificato a questa istanza.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

Parameters

value
StringBuilder

Generatore di stringhe da accodare.The string builder to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation is completed.

Append(UInt16)

Important

This API is not CLS-compliant.

Accoda la rappresentazione di stringa di un intero senza segno a 16 bit specificato a questa istanza.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

Parameters

value
UInt16

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Attributes

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(UInt16) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(UInt16) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il metodo Append(UInt16) chiama il metodo UInt16.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value.The Append(UInt16) method calls the UInt16.ToString(IFormatProvider) method to get the string representation of value. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(UInt32)

Important

This API is not CLS-compliant.

Accoda la rappresentazione di stringa di un intero senza segno a 32 bit specificato a questa istanza.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

Parameters

value
UInt32

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Attributes

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(UInt32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(UInt32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il Append(UInt32) chiama il metodo UInt32.ToString per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(UInt32) calls the UInt32.ToString method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(UInt64)

Important

This API is not CLS-compliant.

Accoda la rappresentazione di stringa di un intero senza segno a 64 bit specificato a questa istanza.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

Parameters

value
UInt64

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Attributes

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(UInt64) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(UInt64) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il metodo Append(UInt64) chiama il metodo UInt64.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(UInt64) method calls the UInt64.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Char[], Int32, Int32)

Accoda la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode a questa istanza.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

Parameters

value
Char[]

Matrice di caratteri.A character array.

startIndex
Int32

Posizione iniziale in value.The starting position in value.

charCount
Int32

Numero di caratteri da accodare.The number of characters to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

value è null e startIndex e charCount sono diversi da zero.value is null, and startIndex and charCount are not zero.

charCount è minore di zero.charCount is less than zero.

-oppure--or-

startIndex è minore di zero.startIndex is less than zero.

-oppure--or-

startIndex + charCount è maggiore della lunghezza di value.startIndex + charCount is greater than the length of value.

-oppure--or-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Questo metodo accoda l'intervallo di caratteri specificato in value all'istanza corrente.This method appends the specified range of characters in value to the current instance. Se value è null e startIndex e count sono entrambi zero, non viene apportata alcuna modifica.If value is null and startIndex and count are both zero, no changes are made.

Il metodo Append(Char[], Int32, Int32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Char[], Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Char*, Int32)

Important

This API is not CLS-compliant.

CLS-compliant alternative
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Accoda a questa istanza una matrice di caratteri Unicode a partire da un indirizzo specificato.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);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Parameters

value
Char*

Puntatore a una matrice di caratteri.A pointer to an array of characters.

valueCount
Int32

Numero di caratteri nella matrice.The number of characters in the array.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Attributes

Exceptions

valueCount è minore di zero.valueCount is less than zero.

-oppure--or-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

value è un puntatore Null.value is a null pointer.

Remarks

Questo metodo aggiunge valueCount caratteri a partire dall'indirizzo value all'istanza corrente.This method appends valueCount characters starting at address value to the current instance.

Il metodo Append(Char*, Int32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Char*, Int32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder.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.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(String)

Accoda una copia della stringa specificata a questa istanza.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

Parameters

value
String

Stringa da accodare.The string to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(String) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(String) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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.

Se value è null, non viene apportata alcuna modifica.If value is null, no changes are made.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(String, Int32, Int32)

Accoda una copia della sottostringa specificata a questa istanza.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

Parameters

value
String

Stringa che contiene la sottostringa da accodare.The string that contains the substring to append.

startIndex
Int32

Posizione iniziale della sottostringa all'interno di value.The starting position of the substring within value.

count
Int32

Numero di caratteri in value da accodare.The number of characters in value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

value è null e startIndex e count sono diversi da zero.value is null, and startIndex and count are not zero.

count è minore di zero.count less than zero.

-oppure--or-

startIndex è minore di zero.startIndex less than zero.

-oppure--or-

startIndex + count è maggiore della lunghezza di value.startIndex + count is greater than the length of value.

-oppure--or-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Questo metodo accoda l'intervallo di caratteri specificato in value all'istanza corrente.This method appends the specified range of characters in value to the current instance. Se value è null e startIndex e count sono entrambi zero, non viene apportata alcuna modifica.If value is null and startIndex and count are both zero, no changes are made.

Il metodo Append(String, Int32, Int32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(String, Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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      

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(StringBuilder, Int32, Int32)

Accoda a questa istanza una copia di una sottostringa all'interno di un generatore di stringhe specificato.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

Parameters

value
StringBuilder

Generatore di stringhe che contiene la sottostringa da accodare.The string builder that contains the substring to append.

startIndex
Int32

Posizione iniziale della sottostringa all'interno di value.The starting position of the substring within value.

count
Int32

Numero di caratteri in value da accodare.The number of characters in value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Append(Char, Int32)

Accoda un numero specificato di copie della rappresentazione di stringa di un carattere Unicode a questa istanza.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

Parameters

value
Char

Carattere da accodare.The character to append.

repeatCount
Int32

Numero delle operazioni di accodamento di value.The number of times to append value.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

repeatCount è minore di zero.repeatCount is less than zero.

-oppure--or-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Memoria esaurita.Out of memory.

Remarks

Il metodo Append(Char, Int32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Char, Int32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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*****

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(SByte)

Important

This API is not CLS-compliant.

Accoda la rappresentazione di stringa di un intero con segno a 8 bit specificato a questa istanza.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

Parameters

value
SByte

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Attributes

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(SByte) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(SByte) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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 

Il metodo Append(SByte) chiama il metodo SByte.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(SByte) method calls the SByte.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Single)

Accoda la rappresentazione di stringa di un numero a virgola mobile a precisione singola specificato a questa istanza.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

Parameters

value
Single

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Single) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Single) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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*****

Il metodo Append(Single) chiama il metodo Single.ToString per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Single) method calls the Single.ToString method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(ReadOnlyMemory<Char>)

Accoda a questa istanza la rappresentazione stringa di un'area di memoria dei caratteri di sola lettura specificata.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

Parameters

value
ReadOnlyMemory<Char>

Area di memoria dei caratteri di sola lettura da accodare.The read-only character memory region to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation is completed.

Append(Boolean)

Accoda la rappresentazione di stringa di un valore booleano specificato a questa istanza.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

Parameters

value
Boolean

Valore booleano da accodare.The Boolean value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Boolean) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Boolean) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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.

Il metodo Append(Boolean) chiama il metodo Boolean.ToString() per ottenere la rappresentazione di stringa di value.The Append(Boolean) method calls the Boolean.ToString() method to get the string representation of value. La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(ReadOnlySpan<Char>)

Accoda a questa istanza la rappresentazione stringa di un intervallo di caratteri di sola lettura specificato.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

Parameters

value
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura da accodare.The read-only character span to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation is completed.

Append(Char)

Accoda la rappresentazione di stringa di un oggetto Char specificato a questa istanza.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

Parameters

value
Char

Unità di codice con codifica UTF-16 da aggiungere.The UTF-16-encoded code unit to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Char) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Char) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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'  '.'      

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Char[])

Accoda la rappresentazione di stringa dei caratteri Unicode in una matrice specificata a questa istanza.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

Parameters

value
Char[]

Matrice di caratteri da accodare.The array of characters to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Questo metodo aggiunge tutti i caratteri nella matrice specificata all'istanza corrente nello stesso ordine in cui appaiono in value.This method appends all the characters in the specified array to the current instance in the same order as they appear in value. Se value è null, non viene apportata alcuna modifica.If value is null, no changes are made.

Il metodo Append(Char[]) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Char[]) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(Decimal)

Accoda la rappresentazione di stringa di un numero decimale specificato a questa istanza.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

Parameters

value
Decimal

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Decimal) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Decimal) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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*****

Il metodo Append(Decimal) chiama il metodo Decimal.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Decimal) method calls the Decimal.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Byte)

Accoda la rappresentazione di stringa di un intero senza segno a 8 bit specificato a questa istanza.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

Parameters

value
Byte

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Byte) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Byte) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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      

Il metodo Append(Byte) chiama il metodo ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Byte) method calls the ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Int16)

Accoda la rappresentazione di stringa di un intero con segno a 16 bit specificato a questa istanza.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

Parameters

value
Int16

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Int16) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Int16) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il metodo Append(Int16) chiama il metodo Int16.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Int16) method calls the Int16.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Int32)

Accoda la rappresentazione di stringa di un intero con segno a 32 bit specificato a questa istanza.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

Parameters

value
Int32

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Int32) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Int32) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il metodo Append(Int32) chiama il metodo Int32.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Int32) method calls the Int32.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Int64)

Accoda la rappresentazione di stringa di un intero con segno a 64 bit specificato a questa istanza.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

Parameters

value
Int64

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Int64) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Int64) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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

Il metodo Append(Int64) chiama il Int64.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Int64) method calls the Int64.ToString(IFormatProvider) to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Object)

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.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

Parameters

value
Object

Oggetto da accodare.The object to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Object) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Object) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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. Definisce una classe di Dog, crea un oggetto Dog ed esegue tre chiamate al metodo Append per creare una stringa che contiene il nome e la generazione del cane.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

Il metodo Append(Object) chiama il metodo Object.ToString per ottenere la rappresentazione di stringa di value.The Append(Object) method calls the Object.ToString method to get the string representation of value. Se value è null, non viene apportata alcuna modifica all'oggetto StringBuilder.If value is null, no changes are made to the StringBuilder object.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Append(Double)

Accoda la rappresentazione di stringa di un numero a virgola mobile e precisione doppia specificato a questa istanza.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

Parameters

value
Double

Valore da accodare.The value to append.

Returns

StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.A reference to this instance after the append operation has completed.

Exceptions

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Remarks

Il metodo Append(Double) modifica l'istanza esistente di questa classe. non restituisce una nuova istanza della classe.The Append(Double) method modifies the existing instance of this class; it does not return a new class instance. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un oggetto StringBuilder, come illustrato nell'esempio riportato di seguito.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*****

Il metodo Append(Double) chiama il metodo Double.ToString(IFormatProvider) per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti.The Append(Double) method calls the Double.ToString(IFormatProvider) method to get the string representation of value for the current culture. Per controllare la formattazione di value, chiamare il metodo AppendFormat.To control the formatting of value, call the AppendFormat method.

La capacità di questa istanza viene regolata in base alle esigenze.The capacity of this instance is adjusted as needed.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.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. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

Applies to