StringBuilder Costruttori

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Runtime.dll

Inizializza una nuova istanza della classe StringBuilder.

Overload

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

StringBuilder()

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 = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Commenti

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

StringBuilder(Int32)

Origine:

StringBuilder.cs

Inizializza una nuova istanza della classe StringBuilder usando 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

Dimensione iniziale consigliata per 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 = gcnew StringBuilder( capacity );

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 possono essere archiviati nella memoria allocata dall'istanza corrente. Il 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

StringBuilder(String)

Origine:

StringBuilder.cs

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

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

public StringBuilder (string? value);

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

Public Sub New (value As String)

Parametri

value

String

Stringa usata per inizializzare il valore dell'istanza. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.

Esempio

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

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );

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 oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.

StringBuilder(Int32, Int32)

Origine:

StringBuilder.cs

Inizializza una nuova istanza della classe StringBuilder 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

Dimensione iniziale consigliata per StringBuilder.

maxCapacity

Int32

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

Eccezioni

ArgumentOutOfRangeException

maxCapacity è minore di 1, 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 = gcnew StringBuilder( capacity,maxCapacity );

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

Il capacity parametro definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente. Il 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.

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

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Origine:

StringBuilder.cs

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

public:
 StringBuilder(System::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 usata per inizializzare il valore dell'istanza. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.

capacity

Int32

Dimensione iniziale consigliata per 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 = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );

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

Il capacity parametro definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente. Il 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.

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

Vedi anche

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Origine:

StringBuilder.cs

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

public:
 StringBuilder(System::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 che contiene la sottostringa usata per inizializzare il valore dell'istanza. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.

startIndex

Int32

Posizione all'interno di value in cui inizia la sottostringa.

length

Int32

Numero di caratteri nella sottostringa.

capacity

Int32

Dimensione iniziale consigliata per StringBuilder.

Eccezioni

ArgumentOutOfRangeException

capacity è minore di zero.

-oppure-

La somma di startIndex e length non corrisponde a una posizione all'interno di value.

Esempio

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

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

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

Il capacity parametro definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente. Il 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.

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

Vedi anche

• Capacity