StringBuilder Constructeurs

  • Référence

Définition

Espace de noms:
System.Text
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Initialise une nouvelle instance de la classe StringBuilder.

Surcharges

StringBuilder()

Initialise une nouvelle instance de la classe StringBuilder.
StringBuilder(Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la capacité spécifiée.
StringBuilder(String)

Initialise une nouvelle instance de la classe StringBuilder à l'aide de la chaîne spécifiée.
StringBuilder(Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder qui commence avec une capacité spécifiée et peut croître jusqu'à un maximum spécifié.
StringBuilder(String, Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la chaîne et la capacité spécifiées.
StringBuilder(String, Int32, Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder à partir de la sous-chaîne et de la capacité spécifiées.

StringBuilder()

Initialise une nouvelle instance de la classe StringBuilder.

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

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur sans paramètres.

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Remarques

La valeur de chaîne de cette instance est définie sur String.Empty, et la capacité est définie sur la capacité par défaut spécifique à l’implémentation.

S’applique à

StringBuilder(Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la capacité spécifiée.

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

Paramètres

capacity
Int32

Taille de départ suggérée de cette instance.

Exceptions

ArgumentOutOfRangeException

capacity est inférieur à zéro.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une capacité spécifiée.

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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères pouvant être stockés dans la mémoire allouée par le instance actuel. Sa valeur est affectée à la Capacity propriété . Si le nombre de caractères à stocker dans le instance actuel dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.

La valeur de chaîne de ce instance est définie sur String.Empty. Si capacity est zéro, la capacité par défaut spécifique à l’implémentation est utilisée.

Voir aussi

S’applique à

StringBuilder(String)

Initialise une nouvelle instance de la classe StringBuilder à l'aide de la chaîne spécifiée.

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)

Paramètres

value
String

Chaîne utilisée pour initialiser la valeur de l'instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec la chaîne spécifiée.

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)

Remarques

Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).

S’applique à

StringBuilder(Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder qui commence avec une capacité spécifiée et peut croître jusqu'à un maximum spécifié.

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)

Paramètres

capacity
Int32

Taille de départ suggérée de StringBuilder.

maxCapacity
Int32

Nombre maximal de caractères que la chaîne actuelle peut contenir.

Exceptions

ArgumentOutOfRangeException

maxCapacity est inférieur à 1, capacity est inférieur à zéro, ou capacity est supérieur à maxCapacity.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une capacité et une capacité maximale spécifiées.

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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères pouvant être stockés dans la mémoire allouée par le instance actuel. Sa valeur est affectée à la Capacity propriété . Si le nombre de caractères à stocker dans le instance actuel dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.

Si capacity est zéro, la capacité par défaut spécifique à l’implémentation est utilisée.

La maxCapacity propriété définit le nombre maximal de caractères que le instance actuel peut contenir. Sa valeur est affectée à la MaxCapacity propriété . Si le nombre de caractères à stocker dans le instance actuel dépasse cette maxCapacity valeur, l’objet StringBuilder n’alloue pas de mémoire supplémentaire, mais lève une exception.

Notes pour les appelants

Dans .NET Core et dans .NET Framework 4.0 et versions ultérieures, lorsque vous instanciez l’objet StringBuilder en appelant le StringBuilder(Int32, Int32) constructeur, la longueur et la capacité du StringBuilder instance peuvent dépasser la valeur de sa MaxCapacity propriété. Cela peut se produire en particulier lorsque vous appelez les Append(String) méthodes et AppendFormat(String, Object) pour ajouter de petites chaînes.

Voir aussi

S’applique à

StringBuilder(String, Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la chaîne et la capacité spécifiées.

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)

Paramètres

value
String

Chaîne utilisée pour initialiser la valeur de l'instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).

capacity
Int32

Taille de départ suggérée de StringBuilder.

Exceptions

ArgumentOutOfRangeException

capacity est inférieur à zéro.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une chaîne initiale et une capacité spécifiée.

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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères pouvant être stockés dans la mémoire allouée par le instance actuel. Sa valeur est affectée à la Capacity propriété . Si le nombre de caractères à stocker dans le instance actuel dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.

Si capacity est zéro, la capacité par défaut spécifique à l’implémentation est utilisée.

Voir aussi

S’applique à

StringBuilder(String, Int32, Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder à partir de la sous-chaîne et de la capacité spécifiées.

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)

Paramètres

value
String

Chaîne contenant la sous-chaîne utilisée pour initialiser la valeur de l'instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).

startIndex
Int32

Position au sein de value où commence la sous-chaîne.

length
Int32

Nombre de caractères dans la sous-chaîne.

capacity
Int32

Taille de départ suggérée de StringBuilder.

Exceptions

ArgumentOutOfRangeException

capacity est inférieur à zéro.

- ou -

startIndex plus length n’est pas une position dans value.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec la chaîne spécifiée.

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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères pouvant être stockés dans la mémoire allouée par le instance actuel. Sa valeur est affectée à la Capacity propriété . Si le nombre de caractères à stocker dans le instance actuel dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.

Si capacity est zéro, la capacité par défaut spécifique à l’implémentation est utilisée.

Voir aussi

S’applique à