Condividi tramite


StringBuilder Costruttori

Definizione

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
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 = 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.

Si applica a

StringBuilder(Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
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

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

Si applica a

StringBuilder(String)

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

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

Si applica a

StringBuilder(Int32, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
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

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

Si applica a

StringBuilder(String, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
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);
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

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

Si applica a

StringBuilder(String, Int32, Int32, Int32)

Origine:
StringBuilder.cs
Origine:
StringBuilder.cs
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);
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

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

Si applica a