Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

StringBuilder.Append, méthode (Char[], Int32, Int32)

Ajoute à cette instance la représentation sous forme de chaîne d'un sous-tableau spécifié de caractères Unicode.

Espace de noms :  System.Text
Assembly :  mscorlib (dans mscorlib.dll)

public StringBuilder Append(
	char[] value,
	int startIndex,
	int charCount
)

Paramètres

value
Type : System.Char[]
Tableau de caractères.
startIndex
Type : System.Int32
Position de départ dans value.
charCount
Type : System.Int32
Nombre de caractères à ajouter.

Valeur de retour

Type : System.Text.StringBuilder
Référence à cette instance après l'opération d'ajout.

ExceptionCondition
ArgumentNullException

value est null et startIndex comme charCount sont différents de zéro.

ArgumentOutOfRangeException

charCount est inférieur à zéro.

ou

startIndex est inférieur à zéro.

ou

startIndex + charCount est supérieur à la longueur de value.

ou

Une augmentation de la valeur de cette instance entraînerait un dépassement de MaxCapacity.

Cette méthode ajoute la plage spécifiée de caractères de value à l'instance actuelle. Si value est null et que startIndex comme count sont égaux à zéro, aucune modification n'est effectuée.

La méthode Append(Char[], Int32, Int32) modifie l'instance existante de cette classe ; elle ne retourne pas de nouvelle instance de classe. C'est pourquoi vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n'avez pas à affecter la valeur de retour à un objet StringBuilder, comme l'illustre l'exemple suivant.


char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.


La capacité de cette instance est ajustée si nécessaire.

Remarques à l'attention des appelants

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

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 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

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft