StringBuilder Constructeurs
Définition
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.
Surcharges
| Nom | Description |
|---|---|
| StringBuilder() |
Initialise une nouvelle instance de la classe StringBuilder. |
| StringBuilder(Int32) |
Initialise une nouvelle instance de la classe à l’aide StringBuilder de la capacité spécifiée. |
| StringBuilder(String) |
Initialise une nouvelle instance de la classe à l’aide StringBuilder de la chaîne spécifiée. |
| StringBuilder(Int32, Int32) |
Initialise une nouvelle instance de la StringBuilder classe qui commence par une capacité spécifiée et peut atteindre un maximum spécifié. |
| StringBuilder(String, Int32) |
Initialise une nouvelle instance de la classe à l’aide de la chaîne et de la StringBuilder capacité spécifiées. |
| StringBuilder(String, Int32, Int32, Int32) |
Initialise une nouvelle instance de la classe à partir de la StringBuilder sous-chaîne et de la capacité spécifiées. |
StringBuilder()
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- 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 = new StringBuilder();
let stringBuilder = 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.
S’applique à
StringBuilder(Int32)
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
Initialise une nouvelle instance de la classe à l’aide StringBuilder de 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 = 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 l’instance actuelle. Sa valeur est affectée à la Capacity propriété. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet StringBuilder alloue de la mémoire supplémentaire pour les stocker.
La valeur de chaîne de cette instance est définie sur String.Empty. Si capacity elle est égale à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.
Voir aussi
S’applique à
StringBuilder(String)
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
Initialise une nouvelle instance de la classe à l’aide StringBuilder 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 c’est nullle cas, le nouveau StringBuilder contient la chaîne vide (autrement dit, elle contient Empty).
Exemples
L’exemple suivant montre comment appeler le StringBuilder constructeur avec la chaîne spécifiée.
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 c’est nullle cas, le nouveau StringBuilder contient la chaîne vide (autrement dit, elle contient Empty).
S’applique à
StringBuilder(Int32, Int32)
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
Initialise une nouvelle instance de la StringBuilder classe qui commence par une capacité spécifiée et peut atteindre 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 du StringBuilder.
- maxCapacity
- Int32
Nombre maximal de caractères que la chaîne actuelle peut contenir.
Exceptions
maxCapacity est inférieur à un, 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é spécifiée et une capacité maximale.
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 l’instance actuelle. Sa valeur est affectée à la Capacity propriété. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet StringBuilder alloue de la mémoire supplémentaire pour les stocker.
Si capacity elle est égale à 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 l’instance actuelle peut contenir. Sa valeur est affectée à la MaxCapacity propriété. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette maxCapacity valeur, l’objet StringBuilder n’alloue pas de mémoire supplémentaire, mais lève plutôt une exception.
Notes pour les appelants
Dans .NET Core et dans .NET Framework 4.0 et versions ultérieures, lorsque vous instanciez l’objet en appelant le StringBuilderStringBuilder(Int32, Int32) constructeur, la longueur et la capacité de l’instance StringBuilder peuvent dépasser la valeur de sa MaxCapacity propriété. Cela peut se produire en particulier lorsque vous appelez les méthodes et Append(String) les AppendFormat(String, Object) méthodes pour ajouter de petites chaînes.
Voir aussi
S’applique à
StringBuilder(String, Int32)
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
Initialise une nouvelle instance de la classe à l’aide de la chaîne et de la StringBuilder 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 c’est nullle cas, le nouveau StringBuilder contient la chaîne vide (autrement dit, elle contient Empty).
- capacity
- Int32
Taille de départ suggérée du 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 = "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 l’instance actuelle. Sa valeur est affectée à la Capacity propriété. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet StringBuilder alloue de la mémoire supplémentaire pour les stocker.
Si capacity elle est égale à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.
Voir aussi
S’applique à
StringBuilder(String, Int32, Int32, Int32)
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
- Source:
- StringBuilder.cs
Initialise une nouvelle instance de la classe à partir de la StringBuilder 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 qui contient la sous-chaîne utilisée pour initialiser la valeur de cette instance. Si value c’est nullle cas, le nouveau StringBuilder contient la chaîne vide (autrement dit, elle contient Empty).
- startIndex
- Int32
Position dans laquelle value 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 du 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 = "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 l’instance actuelle. Sa valeur est affectée à la Capacity propriété. Si le nombre de caractères à stocker dans l’instance actuelle dépasse cette capacity valeur, l’objet StringBuilder alloue de la mémoire supplémentaire pour les stocker.
Si capacity elle est égale à zéro, la capacité par défaut spécifique à l’implémentation est utilisée.
