StringBuilder Constructeurs
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe StringBuilder.
| 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. |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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.StringBuilderPublic Sub New (capacity As Integer)Paramètres
- capacity
- Int32
Taille de départ suggérée de cette instance.
Exceptions
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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.StringBuilderPublic 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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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.StringBuilderPublic 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
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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.StringBuilderPublic 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
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
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.StringBuilderPublic 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
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires: