StringBuilder Classe

Definizione

Spazio dei nomi:

System.Text

Assembly:

mscorlib.dll

Rappresenta una stringa modificabile di caratteri. La classe non può essere ereditata.

public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Ereditarietà

Object

StringBuilder

Attributi

SerializableAttribute ComVisibleAttribute

Implementazioni

ISerializable

Esempio

Nell'esempio seguente viene illustrato come chiamare molti dei metodi definiti dalla StringBuilder classe .

using System;
using System.Text;

public sealed class App
{
    static void Main()
    {
        // Create a StringBuilder that expects to hold 50 characters.
        // Initialize the StringBuilder with "ABC".
        StringBuilder sb = new StringBuilder("ABC", 50);

        // Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(new char[] { 'D', 'E', 'F' });

        // Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", 'J', 'k');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());

        // Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ");

        // Replace all lowercase k's with uppercase K's.
        sb.Replace('k', 'K');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());
    }
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

open System.Text

// Create a StringBuilder that expects to hold 50 characters.
// Initialize the StringBuilder with "ABC".
let sb = StringBuilder("ABC", 50)

// Append three characters (D, E, and F) to the end of the StringBuilder.
sb.Append [| 'D'; 'E'; 'F' |] |> ignore

// Append a format string to the end of the StringBuilder.
sb.AppendFormat("GHI{0}{1}", 'J', 'k') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// Insert a string at the beginning of the StringBuilder.
sb.Insert(0, "Alphabet: ") |> ignore

// Replace all lowercase k's with uppercase K's.
sb.Replace('k', 'K') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

Imports System.Text

Public Module App 
    Public Sub Main() 
        ' Create a StringBuilder that expects to hold 50 characters.
        ' Initialize the StringBuilder with "ABC".
        Dim sb As New StringBuilder("ABC", 50)

        ' Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(New Char() {"D"c, "E"c, "F"c})

        ' Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", "J"c, "k"c)

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())

        ' Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ")

        ' Replace all lowercase k's with uppercase K's.
        sb.Replace("k", "K")

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())
    End Sub
End Module

' This code produces the following output.
'
' 11 chars: ABCDEFGHIJk
' 21 chars: Alphabet: ABCDEFGHIJK

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sull'API per StringBuilder.

Note per i chiamanti

In .NET Core e in .NET Framework 4.0 e versioni successive, quando si crea un'istanza dell'oggetto chiamando il costruttore , sia la lunghezza che la capacità dell'istanza possono aumentare oltre il valore della relativa proprietà /> Append(String) metodi e AppendFormat(String, Object) per accodare stringhe di piccole dimensioni.

Costruttori

Nome	Descrizione
StringBuilder()	Inizializza una nuova istanza della classe StringBuilder.
StringBuilder(Int32, Int32)	Inizializza una nuova istanza della StringBuilder classe che inizia con una capacità specificata e può raggiungere un valore massimo specificato.
StringBuilder(Int32)	Inizializza una nuova istanza della StringBuilder classe utilizzando la capacità specificata.
StringBuilder(String, Int32, Int32, Int32)	Inizializza una nuova istanza della StringBuilder classe dalla sottostringa e dalla capacità specificati.
StringBuilder(String, Int32)	Inizializza una nuova istanza della classe utilizzando la stringa e la StringBuilder capacità specificate.
StringBuilder(String)	Inizializza una nuova istanza della StringBuilder classe utilizzando la stringa specificata.

Proprietà

Nome	Descrizione
Capacity	Ottiene o imposta il numero massimo di caratteri che possono essere contenuti nella memoria allocata dall'istanza corrente.
Chars[Int32]	Ottiene o imposta il carattere in corrispondenza della posizione del carattere specificata in questa istanza.
Length	Ottiene o imposta la lunghezza dell'oggetto corrente StringBuilder .
MaxCapacity	Ottiene la capacità massima di questa istanza.

Metodi

Nome	Descrizione
Append(Boolean)	Aggiunge la rappresentazione di stringa di un valore booleano specificato a questa istanza.
Append(Byte)	Aggiunge la rappresentazione di stringa di un intero senza segno a 8 bit specificato a questa istanza.
Append(Char, Int32)	Aggiunge un numero specificato di copie della rappresentazione di stringa di un carattere Unicode a questa istanza.
Append(Char)	Aggiunge la rappresentazione di stringa di un oggetto specificato Char a questa istanza.
Append(Char[], Int32, Int32)	Aggiunge la rappresentazione di stringa di una sottomaschera specificata di caratteri Unicode a questa istanza.
Append(Char[])	Aggiunge la rappresentazione di stringa dei caratteri Unicode in una matrice specificata a questa istanza.
Append(Char*, Int32)	Aggiunge una matrice di caratteri Unicode a partire da un indirizzo specificato a questa istanza.
Append(Decimal)	Aggiunge la rappresentazione di stringa di un numero decimale specificato a questa istanza.
Append(Double)	Aggiunge la rappresentazione di stringa di un numero a virgola mobile e precisione doppia specificato a questa istanza.
Append(Int16)	Aggiunge la rappresentazione di stringa di un intero con segno a 16 bit specificato a questa istanza.
Append(Int32)	Aggiunge la rappresentazione di stringa di un intero con segno a 32 bit specificato a questa istanza.
Append(Int64)	Aggiunge la rappresentazione di stringa di un intero con segno a 64 bit specificato a questa istanza.
Append(Object)	Aggiunge la rappresentazione di stringa di un oggetto specificato a questa istanza.
Append(SByte)	Aggiunge la rappresentazione di stringa di un intero con segno a 8 bit specificato a questa istanza.
Append(Single)	Aggiunge la rappresentazione di stringa di un numero a virgola mobile e precisione singola specificato a questa istanza.
Append(String, Int32, Int32)	Aggiunge una copia di una sottostringa specificata a questa istanza.
Append(String)	Aggiunge una copia della stringa 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)	Aggiunge la rappresentazione di stringa di un intero senza segno a 32 bit specificato a questa istanza.
Append(UInt64)	Aggiunge la rappresentazione di stringa di un intero senza segno a 64 bit specificato a questa istanza.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di uno di tre argomenti usando un provider di formato specificato.
AppendFormat(IFormatProvider, String, Object, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di uno di due argomenti usando un provider di formato specificato.
AppendFormat(IFormatProvider, String, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di un singolo argomento usando un provider di formato specificato.
AppendFormat(IFormatProvider, String, Object[])	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di un argomento corrispondente in una matrice di parametri usando un provider di formato specificato.
AppendFormat(String, Object, Object, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di uno di tre argomenti.
AppendFormat(String, Object, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di uno di due argomenti.
AppendFormat(String, Object)	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di un singolo argomento.
AppendFormat(String, Object[])	Aggiunge la stringa restituita elaborando una stringa di formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di un argomento corrispondente in una matrice di parametri.
AppendLine()	Aggiunge il carattere di terminazione di riga predefinito alla fine dell'oggetto corrente StringBuilder .
AppendLine(String)	Aggiunge una copia della stringa specificata seguita dal terminatore di riga predefinito alla fine dell'oggetto corrente StringBuilder .
Clear()	Rimuove tutti i caratteri dall'istanza corrente StringBuilder .
CopyTo(Int32, Char[], Int32, Int32)	Copia i caratteri da un segmento specificato di questa istanza in un segmento specificato di una matrice di destinazione Char .
EnsureCapacity(Int32)	Assicura che la capacità di questa istanza di StringBuilder sia almeno il valore specificato.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Equals(StringBuilder)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Insert(Int32, Boolean)	Inserisce la rappresentazione di stringa di un valore booleano in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Byte)	Inserisce la rappresentazione di stringa di un intero senza segno a 8 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Char)	Inserisce la rappresentazione di stringa di un carattere Unicode specificato in questa istanza nella posizione del carattere specificata.
Insert(Int32, Char[], Int32, Int32)	Inserisce la rappresentazione di stringa di una sottoarray specificata di caratteri Unicode in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Char[])	Inserisce la rappresentazione di stringa di una matrice di caratteri Unicode specificata in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Decimal)	Inserisce la rappresentazione di stringa di un numero decimale in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Double)	Inserisce la rappresentazione di stringa di un numero a virgola mobile e precisione doppia in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int16)	Inserisce la rappresentazione di stringa di un intero con segno a 16 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int32)	Inserisce la rappresentazione di stringa di un intero con segno a 32 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int64)	Inserisce la rappresentazione di stringa di un intero con segno a 64 bit in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Object)	Inserisce la rappresentazione di stringa di un oggetto in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, SByte)	Inserisce la rappresentazione di stringa di un intero con segno a 8 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Single)	Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione singola in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, String, Int32)	Inserisce una o più copie di una stringa specificata in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, String)	Inserisce una stringa in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, UInt16)	Inserisce la rappresentazione di stringa di un intero senza segno a 16 bit in questa istanza nella posizione del carattere specificata.
Insert(Int32, UInt32)	Inserisce la rappresentazione di stringa di un intero senza segno a 32 bit in questa istanza nella posizione del carattere specificata.
Insert(Int32, UInt64)	Inserisce la rappresentazione di stringa di un intero senza segno a 64 bit in questa istanza in corrispondenza della posizione del carattere specificata.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Remove(Int32, Int32)	Rimuove l'intervallo di caratteri specificato da questa istanza.
Replace(Char, Char, Int32, Int32)	Sostituisce, all'interno di una sottostringa di questa istanza, tutte le occorrenze di un carattere specificato con un altro carattere specificato.
Replace(Char, Char)	Sostituisce tutte le occorrenze di un carattere specificato in questa istanza con un altro carattere specificato.
Replace(String, String, Int32, Int32)	Sostituisce, all'interno di una sottostringa di questa istanza, tutte le occorrenze di una stringa specificata con un'altra stringa specificata.
Replace(String, String)	Sostituisce tutte le occorrenze di una stringa specificata in questa istanza con un'altra stringa specificata.
ToString()	Converte il valore di questa istanza in un oggetto String.
ToString(Int32, Int32)	Converte il valore di una sottostringa di questa istanza in un oggetto String.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popola un SerializationInfo oggetto con i dati necessari per deserializzare l'oggetto corrente StringBuilder .

Vedi anche

• String