Exporter (0) Imprimer
Développer tout

StringBuilder.AppendFormat, méthode (String, Object, Object)

Mise à jour : novembre 2007

Ajoute à cette instance une chaîne mise en forme qui contient zéro, une ou plusieurs spécifications de format. Chaque spécification de format est remplacée par la représentation sous forme de chaîne d'un argument objet correspondant.

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

public StringBuilder AppendFormat(
	string format,
	Object arg0,
	Object arg1
)
public StringBuilder AppendFormat(
	String format,
	Object arg0,
	Object arg1
)
public function AppendFormat(
	format : String, 
	arg0 : Object, 
	arg1 : Object
) : StringBuilder

Paramètres

format
Type : System.String

Chaîne de format composite.

arg0
Type : System.Object

Premier objet à mettre en forme.

arg1
Type : System.Object

Deuxième objet à mettre en forme.

Valeur de retour

Type : System.Text.StringBuilder

Référence à cette instance après l'ajout de format. Toute spécification de format contenue dans format est remplacée par la représentation sous forme de chaîne de l'argument objet correspondant.

ExceptionCondition
ArgumentNullException

format est null.

FormatException

format est non valide.

ArgumentOutOfRangeException

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

Cette méthode utilise la fonctionnalité de mise en forme composite du .NET Framework pour convertir la valeur d'un objet en sa représentation textuelle et incorporer cette représentation dans l'objet StringBuilder actuel. Le .NET Framework assure une prise en charge de la mise en forme étendue, qui est décrite plus en détail dans les rubriques suivantes relatives à la mise en forme.

Spécifications de format

Les spécifications de format sont incorporées à une chaîne sous la forme {N:FormatString}, où N est un numéro de base zéro indiquant l'argument à mettre en forme et où FormatString est une chaîne de format. Si argN implémente IFormattable, argN.Format (format, null) fournit la mise en forme ; sinon, argN.ToString() fournit la mise en forme. Si argN est null, alors une chaîne vide est utilisée à sa place.

Remplir avec des espaces

Vous pouvez définir une région de l'argument chaîne dans laquelle la valeur mise en forme est justifiée à gauche ou à droite. La spécification de format comprend un champ entier facultatif : {N[,M]:FormatString}. La valeur absolue de M indique le nombre minimal d'espaces pour la région et le signe de M indique si cette valeur doit être justifiée à gauche (valeur négative) ou à droite (valeur positive) dans la région.

Mise en forme par défaut

Lorsque le composant FormatString est omis, la méthode ToString de l'argument spécifié par N est utilisée à la place de la spécification du format. Si M est spécifié, le résultat de ToString est complété par des espaces comme indiqué ci-dessus.

Si la chaîne assignée à format est "Merci d'avoir acheté {0:####} copies de Microsoft® .NET (Core Reference)." et que arg0 est un Int16 ayant la valeur 123, la valeur de retour est alors "Merci d'avoir acheté 123 copies de Microsoft® .NET (Core Reference)."

Si la chaîne assignée à format est "Le chien de Brad a {0,-8:G} puces." et que arg0 est un Int16 ayant la valeur 42, la valeur de retour (où les traits de soulignement représentent des espaces de remplissage) sera alors "Le chien de Brad a 42______ puces."

L'exemple de code suivant illustre la méthode AppendFormat.

using System;
using System.Text;
using System.Globalization;

class Sample 
{
    static StringBuilder sb = new StringBuilder();

    public static void Main() 
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/


// This example demonstrates the StringBuilder.AppendFormat method
import System.*;
import System.Text.*;
import System.Globalization.*;

class Sample
{
    private static StringBuilder sb = new StringBuilder();

    public static void main(String[] args)
    {
        int var1 = 111;
        float var2 = 2.22f;
        String var3 = "abcd";
        Object var4[] = { new Integer(3), new Double(4.4), new Character('X') };

        Console.WriteLine();
        Console.WriteLine("StringBuilder.AppendFormat method:");
        sb.AppendFormat("1) {0}", System.Convert.ToString(var1));
        Show(sb);
        sb.AppendFormat("2) {0}, {1}", System.Convert.ToString(var1), 
            System.Convert.ToString(var2));
        Show(sb);
        sb.AppendFormat("3) {0}, {1}, {2}", System.Convert.ToString(var1), 
            System.Convert.ToString(var2), System.Convert.ToString(var3));
        Show(sb);
        sb.AppendFormat("4) {0}, {1}, {2}", var4);
        Show(sb);
        CultureInfo ci = new CultureInfo("es-ES", true);
        sb.AppendFormat((IFormatProvider)ci, "5) {0}", 
            new Object[] { (System.Single)var2 });
        Show(sb);
    } //main

    public static void Show(StringBuilder sbs)
    {
        Console.WriteLine(sbs.ToString());
        sb.set_Length(0);
    } //Show
} //Sample
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

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

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft