StringBuilder Costruttori
Definizione
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
| 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.StringBuilderPublic 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.StringBuilderPublic 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.StringBuilderPublic 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.StringBuilderPublic 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.StringBuilderPublic 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per