StringBuilder StringBuilder StringBuilder StringBuilder Constructors

Définition

Surcharges

StringBuilder() StringBuilder() StringBuilder()

Initialise une nouvelle instance de la classe StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la capacité spécifiée.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Initialise une nouvelle instance de la classe StringBuilder à l'aide de la chaîne spécifiée.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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é.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la chaîne et la capacité spécifiées.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) 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.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder() StringBuilder() StringBuilder()

Initialise une nouvelle instance de la classe StringBuilder.Initializes a new instance of the StringBuilder class.

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

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur sans paramètres.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

Remarques

La valeur de chaîne de cette instance est définie String.Emptysur, et la capacité est définie sur la capacité par défaut spécifique à l’implémentation.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la capacité spécifiée.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)

Paramètres

capacity
Int32 Int32 Int32 Int32

Taille de départ suggérée de cette instance.The suggested starting size of this instance.

Exceptions

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une capacité spécifiée.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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères qui peuvent être stockés dans la mémoire allouée par l’instance actuelle.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Sa valeur est assignée Capacity à la propriété.Its value is assigned to the Capacity property. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.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.

La valeur de chaîne de cette instance est définie String.Emptysur.The string value of this instance is set to String.Empty. Si capacity est égal à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.If capacity is zero, the implementation-specific default capacity is used.

Voir aussi

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Initialise une nouvelle instance de la classe StringBuilder à l'aide de la chaîne spécifiée.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)

Paramètres

value
String String String String

Chaîne utilisée pour initialiser la valeur de l'instance.The string used to initialize the value of the instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec la chaîne spécifiée.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)

Remarques

Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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é.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)

Paramètres

capacity
Int32 Int32 Int32 Int32

Taille de départ suggérée de StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32 Int32 Int32 Int32

Nombre maximal de caractères que la chaîne actuelle peut contenir.The maximum number of characters the current string can contain.

Exceptions

maxCapacity est inférieur à 1, capacity est inférieur à zéro, ou capacity est supérieur à maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une capacité et une capacité maximale spécifiées.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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères qui peuvent être stockés dans la mémoire allouée par l’instance actuelle.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Sa valeur est assignée Capacity à la propriété.Its value is assigned to the Capacity property. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.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.

Si capacity est égal à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.If capacity is zero, the implementation-specific default capacity is used.

La maxCapacity propriété définit le nombre maximal de caractères que l’instance actuelle peut contenir.The maxCapacity property defines the maximum number of characters that the current instance can hold. Sa valeur est assignée MaxCapacity à la propriété.Its value is assigned to the MaxCapacity property. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette maxCapacity valeur, l’objet n’alloue pas de mémoire supplémentaire, mais lève à la StringBuilder place une exception.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 pour les appelants

Dans .net Core et dans le .NET Framework 4,0 et versions ultérieures, quand StringBuilder vous instanciez l’objet en appelant le StringBuilder(Int32, Int32) constructeur, la longueur et la capacité de StringBuilder l’instance peuvent croître au-delà de MaxCapacity la valeur de son propriété.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. Cela peut se produire en particulier lorsque vous Append(String) appelez AppendFormat(String, Object) les méthodes et pour ajouter des chaînes de petite taille.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Voir aussi

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la chaîne et la capacité spécifiées.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)

Paramètres

value
String String String String

Chaîne utilisée pour initialiser la valeur de l'instance.The string used to initialize the value of the instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32 Int32 Int32 Int32

Taille de départ suggérée de StringBuilder.The suggested starting size of the StringBuilder.

Exceptions

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec une chaîne initiale et une capacité spécifiée.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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères qui peuvent être stockés dans la mémoire allouée par l’instance actuelle.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Sa valeur est assignée Capacity à la propriété.Its value is assigned to the Capacity property. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.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.

Si capacity est égal à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.If capacity is zero, the implementation-specific default capacity is used.

Voir aussi

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) 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.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)

Paramètres

value
String String String String

Chaîne contenant la sous-chaîne utilisée pour initialiser la valeur de l'instance.The string that contains the substring used to initialize the value of this instance. Si value est null, le nouveau StringBuilder contient la chaîne vide (il contient Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32 Int32 Int32 Int32

Position au sein de value où commence la sous-chaîne.The position within value where the substring begins.

length
Int32 Int32 Int32 Int32

Nombre de caractères dans la sous-chaîne.The number of characters in the substring.

capacity
Int32 Int32 Int32 Int32

Taille de départ suggérée de StringBuilder.The suggested starting size of the StringBuilder.

Exceptions

capacity est inférieur à zéro.capacity is less than zero.

- ou --or- startIndex plus length n’est pas une position dans value.startIndex plus length is not a position within value.

Exemples

L’exemple suivant montre comment appeler le StringBuilder constructeur avec la chaîne spécifiée.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)

Remarques

Le capacity paramètre définit le nombre maximal de caractères qui peuvent être stockés dans la mémoire allouée par l’instance actuelle.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Sa valeur est assignée Capacity à la propriété.Its value is assigned to the Capacity property. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet alloue de la StringBuilder mémoire supplémentaire pour les stocker.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.

Si capacity est égal à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.If capacity is zero, the implementation-specific default capacity is used.

Voir aussi

S’applique à