StringBuilder Costruttori

Definizione

Spazio dei nomi:: System.Text

Assembly:: mscorlib.dll, System.Runtime.dll

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe StringBuilder.

Overload

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

StringBuilder()

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della classe StringBuilder.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore senza parametri.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Commenti

Il valore stringa di questa istanza è impostato su String.Emptye la capacità è impostata sulla capacità predefinita specifica dell'implementazione.

Si applica a

StringBuilder(Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della StringBuilder classe utilizzando la capacità specificata.

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

Parametri

capacity: Int32

Dimensioni iniziali suggerite di questa istanza.

Eccezioni

ArgumentOutOfRangeException

capacity è minore di zero.

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore con una capacità specificata.

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Commenti

Il capacity parametro definisce il numero massimo di caratteri che è possibile archiviare nella memoria allocata dall'istanza corrente. Il relativo valore viene assegnato alla Capacity proprietà . Se il numero di caratteri da archiviare nell'istanza corrente supera questo capacity valore, l'oggetto StringBuilder alloca memoria aggiuntiva per archiviarli.

Il valore stringa di questa istanza è impostato su String.Empty. Se capacity è zero, viene usata la capacità predefinita specifica dell'implementazione.

Vedi anche

Capacity

Si applica a

StringBuilder(String)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della StringBuilder classe utilizzando la stringa specificata.

public:
 StringBuilder(System::String ^ value);

public StringBuilder(string value);

public StringBuilder(string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

Parametri

value: String

Stringa utilizzata per inizializzare il valore dell'istanza. Se value è null, il nuovo StringBuilder conterrà la stringa vuota , ovvero contiene Empty.

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore con la stringa specificata.

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Commenti

Se value è null, il nuovo StringBuilder conterrà la stringa vuota , ovvero contiene Empty.

Si applica a

StringBuilder(Int32, Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della StringBuilder classe che inizia con una capacità specificata e può raggiungere un valore massimo specificato.

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder(int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

Parametri

capacity: Int32

Dimensioni iniziali suggerite di StringBuilder.

maxCapacity: Int32

Numero massimo di caratteri che la stringa corrente può contenere.

Eccezioni

ArgumentOutOfRangeException

maxCapacity è minore di uno, capacity è minore di zero o capacity è maggiore di maxCapacity.

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore con una capacità e una capacità massima specificate.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Commenti

Se capacity è zero, viene usata la capacità predefinita specifica dell'implementazione.

La maxCapacity proprietà definisce il numero massimo di caratteri che l'istanza corrente può contenere. Il relativo valore viene assegnato alla MaxCapacity proprietà . Se il numero di caratteri da archiviare nell'istanza corrente supera questo maxCapacity valore, l'oggetto StringBuilder non alloca memoria aggiuntiva, ma genera invece un'eccezione.

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, sia la lunghezza che 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

StringBuilder(String, Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della classe utilizzando la stringa e la StringBuilder capacità specificate.

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder(string value, int capacity);

public StringBuilder(string? value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

Parametri

value: String

Stringa utilizzata per inizializzare il valore dell'istanza. Se value è null, il nuovo StringBuilder conterrà la stringa vuota , ovvero contiene Empty.

capacity: Int32

Dimensioni iniziali suggerite di StringBuilder.

Eccezioni

ArgumentOutOfRangeException

capacity è minore di zero.

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore con una stringa iniziale e una capacità specificata.

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Commenti

Se capacity è zero, viene usata la capacità predefinita specifica dell'implementazione.

Vedi anche

Capacity

Si applica a

StringBuilder(String, Int32, Int32, Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Inizializza una nuova istanza della StringBuilder classe dalla sottostringa e dalla capacità specificati.

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);

public StringBuilder(string value, int startIndex, int length, int capacity);

public StringBuilder(string? value, int startIndex, int length, int capacity);

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parametri

value: String

Stringa contenente la sottostringa utilizzata per inizializzare il valore di questa istanza. Se value è null, il nuovo StringBuilder conterrà la stringa vuota , ovvero contiene Empty.

startIndex: Int32

Posizione all'interno della value quale inizia la sottostringa.

length: Int32

Numero di caratteri nella sottostringa.

capacity: Int32

Dimensioni iniziali suggerite di StringBuilder.

Eccezioni

ArgumentOutOfRangeException

capacity è minore di zero.

oppure

startIndex plus length non è una posizione all'interno valuedi .

Esempio

Nell'esempio seguente viene illustrato come chiamare il StringBuilder costruttore con la stringa specificata.

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

Commenti

Se capacity è zero, viene usata la capacità predefinita specifica dell'implementazione.

Vedi anche

Capacity

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

StringBuilder Costruttori

Definizione

Overload

StringBuilder()

Esempio

Commenti

Si applica a

StringBuilder(Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StringBuilder(String)

Parametri

Esempio

Commenti

Si applica a

StringBuilder(Int32, Int32)

Parametri

Eccezioni

Esempio

Commenti

Note per i chiamanti

Vedi anche

Si applica a

StringBuilder(String, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StringBuilder(String, Int32, Int32, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti