StringBuilder Constructors

Definition

Inizializza una nuova istanza della classe StringBuilder.Initializes a new instance of the StringBuilder class.

Overloads

StringBuilder()

Inizializza una nuova istanza della classe StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32)

Inizializza una nuova istanza della classe StringBuilder usando la capacità specificata.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String)

Inizializza una nuova istanza della classe StringBuilder usando la stringa specificata.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32)

Inizializza una nuova istanza della classe StringBuilder che inizia con una capacità specificata e può raggiungere un valore massimo specificato.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32)

Inizializza una nuova istanza della classe StringBuilder usando la stringa e la capacità specificate.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32)

Inizializza una nuova istanza della classe StringBuilder dalla sottostringa e la capacità specificate.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder()

Inizializza una nuova istanza della classe StringBuilder.Initializes a new instance of the StringBuilder class.

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder senza parametri.The following example demonstrates how to call the StringBuilder constructor with no parameters.

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
Dim stringBuilder As New StringBuilder

Remarks

Il valore stringa di questa istanza è impostato su String.Emptye la capacità è impostata sulla capacità predefinita specifica dell'implementazione.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32)

Inizializza una nuova istanza della classe StringBuilder usando la capacità specificata.Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

Parameters

capacity
Int32

Dimensione iniziale consigliata per questa istanza.The suggested starting size of this instance.

Exceptions

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

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder con una capacità specificata.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Remarks

Il parametro capacity definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Il relativo valore viene assegnato alla proprietà Capacity.Its value is assigned to the Capacity property. Se il numero di caratteri da archiviare nell'istanza corrente supera questo valore capacity, l'oggetto StringBuilder alloca memoria aggiuntiva per archiviarli.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Il valore stringa di questa istanza è impostato su String.Empty.The string value of this instance is set to String.Empty. Se capacity è zero, viene utilizzata la capacità predefinita specifica dell'implementazione.If capacity is zero, the implementation-specific default capacity is used.

See also

StringBuilder(String)

Inizializza una nuova istanza della classe StringBuilder usando la stringa specificata.Initializes a new instance of the StringBuilder class using the specified string.

public:
 StringBuilder(System::String ^ value);
public StringBuilder (string value);
new System.Text.StringBuilder : string -> System.Text.StringBuilder
Public Sub New (value As String)

Parameters

value
String

Stringa usata per inizializzare il valore dell'istanza.The string used to initialize the value of the instance. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder con la stringa specificata.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Remarks

Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32)

Inizializza una nuova istanza della classe StringBuilder che inizia con una capacità specificata e può raggiungere un valore massimo specificato.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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)

Parameters

capacity
Int32

Dimensione iniziale consigliata per StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32

Numero massimo di caratteri che la stringa corrente può contenere.The maximum number of characters the current string can contain.

Exceptions

maxCapacity è minore di 1, capacity è minore di zero o capacity è maggiore di maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder con la capacità e la capacità massima specificate.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Remarks

Il parametro capacity definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Il relativo valore viene assegnato alla proprietà Capacity.Its value is assigned to the Capacity property. Se il numero di caratteri da archiviare nell'istanza corrente supera questo valore capacity, l'oggetto StringBuilder alloca memoria aggiuntiva per archiviarli.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity è zero, viene utilizzata la capacità predefinita specifica dell'implementazione.If capacity is zero, the implementation-specific default capacity is used.

La proprietà maxCapacity definisce il numero massimo di caratteri che l'istanza corrente può mantenere.The maxCapacity property defines the maximum number of characters that the current instance can hold. Il relativo valore viene assegnato alla proprietà MaxCapacity.Its value is assigned to the MaxCapacity property. 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.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

Notes to Callers

In .NET Core e in .NET Framework 4,0 e versioni successive, quando si crea un'istanza dell'oggetto StringBuilder chiamando il costruttore StringBuilder(Int32, Int32), la lunghezza e la capacità dell'istanza di StringBuilder possono superare il valore della relativa proprietà di MaxCapacity.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Questa situazione può verificarsi in particolare quando si chiamano i metodi Append(String) e AppendFormat(String, Object) per aggiungere stringhe di piccole dimensioni.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

See also

StringBuilder(String, Int32)

Inizializza una nuova istanza della classe StringBuilder usando la stringa e la capacità specificate.Initializes a new instance of the StringBuilder class using the specified string and capacity.

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)

Parameters

value
String

Stringa usata per inizializzare il valore dell'istanza.The string used to initialize the value of the instance. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32

Dimensione iniziale consigliata per StringBuilder.The suggested starting size of the StringBuilder.

Exceptions

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

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder con una stringa iniziale e una capacità specificata.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

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);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Remarks

Il parametro capacity definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Il relativo valore viene assegnato alla proprietà Capacity.Its value is assigned to the Capacity property. Se il numero di caratteri da archiviare nell'istanza corrente supera questo valore capacity, l'oggetto StringBuilder alloca memoria aggiuntiva per archiviarli.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity è zero, viene utilizzata la capacità predefinita specifica dell'implementazione.If capacity is zero, the implementation-specific default capacity is used.

See also

StringBuilder(String, Int32, Int32, Int32)

Inizializza una nuova istanza della classe StringBuilder dalla sottostringa e la capacità specificate.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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)

Parameters

value
String

Stringa che contiene la sottostringa usata per inizializzare il valore dell'istanza.The string that contains the substring used to initialize the value of this instance. Se value è null, il nuovo oggetto StringBuilder conterrà una stringa vuota, ovvero Empty.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32

Posizione all'interno di value in cui inizia la sottostringa.The position within value where the substring begins.

length
Int32

Numero di caratteri nella sottostringa.The number of characters in the substring.

capacity
Int32

Dimensione iniziale consigliata per StringBuilder.The suggested starting size of the StringBuilder.

Exceptions

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

-oppure--or-

La somma di startIndex e length non corrisponde a una posizione all'interno di value.startIndex plus length is not a position within value.

Examples

Nell'esempio seguente viene illustrato come chiamare il costruttore StringBuilder con la stringa specificata.The following example demonstrates how to call the StringBuilder constructor with the specified string.

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);
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)

Remarks

Il parametro capacity definisce il numero massimo di caratteri che possono essere archiviati nella memoria allocata dall'istanza corrente.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Il relativo valore viene assegnato alla proprietà Capacity.Its value is assigned to the Capacity property. Se il numero di caratteri da archiviare nell'istanza corrente supera questo valore capacity, l'oggetto StringBuilder alloca memoria aggiuntiva per archiviarli.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity è zero, viene utilizzata la capacità predefinita specifica dell'implementazione.If capacity is zero, the implementation-specific default capacity is used.

See also

Applies to