StringBuilder.Append Metodo

Definizione

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.

Overload

Append(StringBuilder)

Accoda la rappresentazione stringa di un generatore di stringhe specificato a questa istanza.

Append(StringBuilder+AppendInterpolatedStringHandler)

Aggiunge la stringa interpolata specificata a questa istanza.

Append(UInt16)

Accoda la rappresentazione di stringa di un intero senza segno a 16 bit specificato a questa istanza.

Append(UInt32)

Accoda la rappresentazione di stringa di un intero senza segno a 32 bit specificato a questa istanza.

Append(Char, Int32)

Accoda un numero specificato di copie della rappresentazione di stringa di un carattere Unicode a questa istanza.

Append(Char[], Int32, Int32)

Accoda la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode a questa istanza.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Aggiunge la stringa interpolata specificata a questa istanza usando il formato specificato.

Append(String)

Accoda una copia della stringa specificata a questa istanza.

Append(String, Int32, Int32)

Accoda una copia della sottostringa specificata a questa istanza.

Append(StringBuilder, Int32, Int32)

Accoda a questa istanza una copia di una sottostringa all'interno di un generatore di stringhe specificato.

Append(Char*, Int32)

Accoda a questa istanza una matrice di caratteri Unicode a partire da un indirizzo specificato.

Append(Single)

Accoda la rappresentazione di stringa di un numero a virgola mobile a precisione singola specificato a questa istanza.

Append(UInt64)

Accoda la rappresentazione di stringa di un intero senza segno a 64 bit specificato a questa istanza.

Append(ReadOnlySpan<Char>)

Accoda a questa istanza la rappresentazione stringa di un intervallo di caratteri di sola lettura specificato.

Append(SByte)

Accoda la rappresentazione di stringa di un intero con segno a 8 bit specificato a questa istanza.

Append(Boolean)

Accoda la rappresentazione di stringa di un valore booleano specificato a questa istanza.

Append(Byte)

Accoda la rappresentazione di stringa di un intero senza segno a 8 bit specificato a questa istanza.

Append(Char)

Accoda la rappresentazione di stringa di un oggetto Char specificato a questa istanza.

Append(Decimal)

Accoda la rappresentazione di stringa di un numero decimale specificato a questa istanza.

Append(Double)

Accoda la rappresentazione di stringa di un numero a virgola mobile e precisione doppia specificato a questa istanza.

Append(Char[])

Accoda la rappresentazione di stringa dei caratteri Unicode in una matrice specificata a questa istanza.

Append(Int16)

Accoda la rappresentazione di stringa di un intero con segno a 16 bit specificato a questa istanza.

Append(Int32)

Accoda la rappresentazione di stringa di un intero con segno a 32 bit specificato a questa istanza.

Append(Int64)

Accoda la rappresentazione di stringa di un intero con segno a 64 bit specificato a questa istanza.

Append(Object)

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.

Append(ReadOnlyMemory<Char>)

Accoda a questa istanza la rappresentazione stringa di un'area di memoria dei caratteri di sola lettura specificata.

Append(StringBuilder)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione stringa di un generatore di stringhe specificato a questa istanza.

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

Parametri

value
StringBuilder

Generatore di stringhe da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a

Append(StringBuilder+AppendInterpolatedStringHandler)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Aggiunge la stringa interpolata specificata a questa istanza.

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

Parametri

handler
StringBuilder.AppendInterpolatedStringHandler

Stringa interpolata da aggiungere.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a

Append(UInt16)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Accoda la rappresentazione di stringa di un intero senza segno a 16 bit specificato a questa istanza.

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

Parametri

value
UInt16

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Attributi

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(UInt16) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

Il Append(UInt16) metodo chiama il UInt16.ToString(IFormatProvider) metodo per ottenere la rappresentazione stringa di value. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(UInt32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Accoda la rappresentazione di stringa di un intero senza segno a 32 bit specificato a questa istanza.

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

Parametri

value
UInt32

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Attributi

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(UInt32) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

Chiama Append(UInt32) il UInt32.ToString metodo per ottenere la rappresentazione stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Char, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda un numero specificato di copie della rappresentazione di stringa di un carattere Unicode a questa istanza.

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

Parametri

value
Char

Carattere da accodare.

repeatCount
Int32

Numero delle operazioni di accodamento di value.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

repeatCount è minore di zero.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Memoria insufficiente.

Commenti

Il Append(Char, Int32) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Char[], Int32, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode a questa istanza.

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

Parametri

value
Char[]

Matrice di caratteri.

startIndex
Int32

Posizione iniziale in value.

charCount
Int32

Numero di caratteri da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

value è null e startIndex e charCount sono diversi da zero.

charCount è minore di zero.

-oppure-

startIndex è minore di zero.

-oppure-

startIndex + charCount è maggiore della lunghezza di value.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Questo metodo aggiunge l'intervallo di caratteri specificato nell'istanza value corrente. Se value è null e count sono entrambi startIndex zero, non vengono apportate modifiche.

Il Append(Char[], Int32, Int32) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

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

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

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Aggiunge la stringa interpolata specificata a questa istanza usando il formato specificato.

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

Parametri

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

handler
StringBuilder.AppendInterpolatedStringHandler

Stringa interpolata da aggiungere.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a

Append(String)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda una copia della stringa specificata a questa istanza.

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

Parametri

value
String

Stringa da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(String) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

Se value è null, non vengono apportate modifiche.

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(String, Int32, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda una copia della sottostringa specificata a questa istanza.

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

Parametri

value
String

Stringa che contiene la sottostringa da accodare.

startIndex
Int32

Posizione iniziale della sottostringa all'interno di value.

count
Int32

Numero di caratteri in value da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

value è null e startIndex e count sono diversi da zero.

count è minore di zero.

-oppure-

startIndex è minore di zero.

-oppure-

startIndex + count è maggiore della lunghezza di value.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Questo metodo aggiunge l'intervallo di caratteri specificato nell'istanza value corrente. Se value è null e count sono entrambi startIndex zero, non vengono apportate modifiche.

Il Append(String, Int32, Int32) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

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

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

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(StringBuilder, Int32, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda a questa istanza una copia di una sottostringa all'interno di un generatore di stringhe specificato.

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

Parametri

value
StringBuilder

Generatore di stringhe che contiene la sottostringa da accodare.

startIndex
Int32

Posizione iniziale della sottostringa all'interno di value.

count
Int32

Numero di caratteri in value da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a

Append(Char*, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Alternativa conforme a CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Accoda a questa istanza una matrice di caratteri Unicode a partire da un indirizzo specificato.

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

Parametri

value
Char*

Puntatore a una matrice di caratteri.

valueCount
Int32

Numero di caratteri nella matrice.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Attributi

Eccezioni

valueCount è minore di zero.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

value è un puntatore Null.

Commenti

Questo metodo aggiunge valueCount caratteri a partire dall'indirizzo value all'istanza corrente.

Il Append(Char*, Int32) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto.

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Si applica a

Append(Single)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un numero a virgola mobile a precisione singola specificato a questa istanza.

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

Parametri

value
Single

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Single) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

Il Append(Single) metodo chiama il Single.ToString metodo per ottenere la rappresentazione stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(UInt64)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Accoda la rappresentazione di stringa di un intero senza segno a 64 bit specificato a questa istanza.

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

Parametri

value
UInt64

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Attributi

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(UInt64) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente.

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

Il Append(UInt64) metodo chiama il UInt64.ToString(IFormatProvider) metodo per ottenere la rappresentazione stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(ReadOnlySpan<Char>)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda a questa istanza la rappresentazione stringa di un intervallo di caratteri di sola lettura specificato.

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

Parametri

value
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a

Append(SByte)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Accoda la rappresentazione di stringa di un intero con segno a 8 bit specificato a questa istanza.

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

Parametri

value
SByte

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Attributi

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(SByte) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(SByte) metodo chiama il SByte.ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Boolean)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un valore booleano specificato a questa istanza.

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

Parametri

value
Boolean

Valore booleano da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Boolean) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Boolean) metodo chiama il Boolean.ToString() metodo per ottenere la rappresentazione di stringa di value. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Byte)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un intero senza segno a 8 bit specificato a questa istanza.

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

Parametri

value
Byte

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Byte) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

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

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

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

Il Append(Byte) metodo chiama il ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Char)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un oggetto Char specificato a questa istanza.

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

Parametri

value
Char

Unità di codice con codifica UTF-16 da aggiungere.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Char) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

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

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

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

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Decimal)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un numero decimale specificato a questa istanza.

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

Parametri

value
Decimal

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Decimal) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Decimal) metodo chiama il Decimal.ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Double)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un numero a virgola mobile e precisione doppia specificato a questa istanza.

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

Parametri

value
Double

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Double) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Double) metodo chiama il Double.ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Char[])

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa dei caratteri Unicode in una matrice specificata a questa istanza.

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

Parametri

value
Char[]

Matrice di caratteri da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Questo metodo aggiunge tutti i caratteri nella matrice specificata all'istanza corrente nello stesso ordine in cui vengono visualizzati in value. Se value è null, non vengono apportate modifiche.

Il Append(Char[]) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Si applica a

Append(Int16)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un intero con segno a 16 bit specificato a questa istanza.

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

Parametri

value
Int16

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Int16) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Int16) metodo chiama il Int16.ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un intero con segno a 32 bit specificato a questa istanza.

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

Parametri

value
Int32

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Int32) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Int32) metodo chiama il Int32.ToString(IFormatProvider) metodo per ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Int64)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un intero con segno a 64 bit specificato a questa istanza.

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

Parametri

value
Int64

Valore da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Int64) metodo modifica l'istanza esistente di questa classe e non restituisce una nuova istanza di classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto , come illustrato nell'esempio seguente.

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

Il Append(Int64) metodo chiama per Int64.ToString(IFormatProvider) ottenere la rappresentazione di stringa di value per le impostazioni cultura correnti. Per controllare la formattazione di value, chiamare il AppendFormat metodo .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il StringBuilder(Int32, Int32) costruttore, la lunghezza e la capacità dell'istanza StringBuilder possono aumentare oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(Object)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda la rappresentazione di stringa di un oggetto specificato a questa istanza.

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

Parametri

value
Object

Oggetto da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Eccezioni

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Il Append(Object) metodo modifica l'istanza esistente di questa classe. Non restituisce una nuova istanza di classe. A causa di questo, è possibile chiamare un metodo o una proprietà nel riferimento esistente e non è necessario assegnare il valore restituito a un StringBuilder oggetto, come illustrato nell'esempio seguente. Definisce una Dog classe, crea un Dog oggetto e effettua tre chiamate al Append metodo per creare una stringa contenente il nome e la razza del cane.

using System;

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

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

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

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

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

Il Append(Object) metodo chiama il Object.ToString metodo per ottenere la rappresentazione stringa di value. Se value è null, non vengono apportate modifiche all'oggetto StringBuilder .

La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Core e nelle versioni successive di .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il StringBuilderStringBuilder(Int32, Int32) costruttore, sia la lunghezza che la capacità dell'istanza StringBuilder possono crescere oltre il valore della relativa MaxCapacity proprietà. Ciò può verificarsi in particolare quando si chiamano i Append(String) metodi e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.

Vedi anche

Si applica a

Append(ReadOnlyMemory<Char>)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
Origine:
StringBuilder.cs

Accoda a questa istanza la rappresentazione stringa di un'area di memoria dei caratteri di sola lettura specificata.

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

Parametri

value
ReadOnlyMemory<Char>

Area di memoria dei caratteri di sola lettura da accodare.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Si applica a