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.Append, méthode (Object)

Ajoute à cette instance la représentation sous forme de chaîne d'un objet spécifié.

Espace de noms :  System.Text
Assembly :  mscorlib (dans mscorlib.dll)
public StringBuilder Append(
	Object value
)

Paramètres

value
Type : System.Object
Objet à ajouter.

Valeur de retour

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

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

La méthode Append 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. Il définit une classe Dog, crée un objet Dog et passe trois appels à la méthode Append pour créer une chaîne qui contient le nom du chien et la race.


using System;

public class Dog
{
   private string dogBreed;
   private string dogName;

   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }

   public string Breed {
      get { return this.dogBreed; }
   }

   public string Name {
      get { return this.dogName; }
   }

   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute


La méthode Append appelle la méthode Object.ToString pour obtenir la représentation sous forme de chaîne de value. Si la value est null, aucune modification n'est apportée à l'objet StringBuilder.

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

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.

Date

Historique

Motif

Décembre 2010

Section Notes développée et exemple supprimé.

Commentaires client.

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.