Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

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

Espace de noms :  System.Text
Assembly :  mscorlib (dans mscorlib.dll)
public StringBuilder(
	int capacity,
	int maxCapacity
)

Paramètres

capacity
Type : System.Int32
Taille de départ suggérée de StringBuilder.
maxCapacity
Type : System.Int32
Nombre maximal de caractères que la chaîne en cours peut contenir.
ExceptionCondition
ArgumentOutOfRangeException

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

Le paramètre capacity définit le nombre maximal de caractères que peut contenir la mémoire allouée par l'instance actuelle. Sa valeur est assignée à la propriété Capacity. Si le nombre de caractères à stocker dans l'instance actuelle dépasse cette valeur capacity, l'objet StringBuilder alloue de la mémoire supplémentaire pour les stocker.

Si capacity est égal à zéro, la capacité par défaut propre à l'implémentation est utilisée.

La propriété maxCapacity définit le nombre maximal des caractères que l'instance actuelle peut maintenir. Sa valeur est assignée à la propriété MaxCapacity. Si le nombre de caractères à stocker dans l'instance actuelle dépasse cette valeur maxCapacity, l'objet StringBuilder n'alloue pas de mémoire additionnelle, mais à la place lève une exception.

Remarques à l'attention des appelants

Dans .NET Framework 4 et .NET Framework 4.5, lorsque vous instanciez l'objet StringBuilder en appelant le constructeur de StringBuilder(Int32, Int32), la longueur et l'instance d'StringBuilder peuvent développer au delà de la valeur de sa propriété d'MaxCapacity. Cela peut se produire en particulier lorsque vous appelez les méthodes d'Append et AppendFormat pour ajouter de petites chaînes.

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


int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);


.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft. Tous droits réservés.