Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo StringBuilder.AppendFormat (String, Object, Object, Object)

 

Data di pubblicazione: novembre 2016

Accoda la stringa restituita dall'elaborazione di una stringa in formato composito, che contiene zero o più elementi di formato, a questa istanza. Ogni elemento di formato viene sostituito dalla rappresentazione di stringa di uno dei tre argomenti.

Spazio dei nomi:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

public StringBuilder AppendFormat(
	string format,
	object arg0,
	object arg1,
	object arg2
)

Parametri

format
Type: System.String

Stringa in formato composito (vedere la sezione Note).

arg0
Type: System.Object

Primo oggetto da formattare.

arg1
Type: System.Object

Secondo oggetto da formattare.

arg2
Type: System.Object

Terzo oggetto da formattare.

Valore restituito

Type: System.Text.StringBuilder

Riferimento a questa istanza con format accodato. Ogni elemento di formato in format viene sostituito dalla rappresentazione di stringa dell'argomento dell'oggetto corrispondente.

Exception Condition
ArgumentNullException

format è null.

FormatException

format non è valido.

-oppure-

L'indice di un elemento di formato è minore di 0 (zero) oppure maggiore o uguale a 3 (due).

ArgumentOutOfRangeException

La lunghezza della stringa espansa supererebbe MaxCapacity.

Questo metodo utilizza il funzionalità di formattazione composta di .NET Framework per convertire il valore di un oggetto nella relativa rappresentazione di testo e incorporare tale rappresentazione nell'attuale StringBuilder oggetto.

Il format parametro consiste di zero o più esecuzioni di testo combinato con zero o più segnaposto indicizzati, denominati elementi di formato, corrispondenti a arg0 tramite arg2, gli oggetti nell'elenco dei parametri di questo metodo. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa dell'oggetto corrispondente.

La sintassi di un elemento di formato è come segue:

{indice[,lunghezza] [:formatString]}

Gli elementi racchiusa tra parentesi quadre sono facoltativi. Nella tabella seguente viene descritto ogni elemento.

Elemento

Descrizione

indice

Posizione nell'elenco dei parametri in base zero dell'oggetto da formattare. Se l'oggetto specificato da indice è null, l'elemento di formato viene sostituito da String.Empty. Se non esiste alcun parametro nel indice posizione, un FormatException viene generata un'eccezione.

,lunghezza

Il numero minimo di caratteri nella rappresentazione di stringa del parametro. Se è positivo, il parametro è allineato a destra; Se è negativo, è allineato a sinistra.

:formatString

Una stringa di formato standard o personalizzato che è supportata dal parametro.

System_CAPS_noteNota

Per le stringhe di formato standard e personalizzati utilizzate con valori di data e ora, vedere Stringhe di formato di data e ora standard e Stringhe di formato di data e ora personalizzato. Per le stringhe di formato standard e personalizzate utilizzate con i valori numerici, vedere Stringhe di formato numerico standard e Stringhe di formato numerico personalizzato. Per le stringhe di formato standard utilizzate con enumerazioni, vedere Stringhe di formato di enumerazione.

arg0, arg1, e arg2 rappresentano gli oggetti da formattare. Ogni elemento di formato in format viene sostituito con la rappresentazione di stringa di arg0, arg1, o arg2, in base all'indice dell'elemento di formato. Se l'elemento di formato include formatString e l'oggetto corrispondente in args implementa il IFormattable interfaccia, quindi argx.ToString(formatString, null) definisce la formattazione, in cui x è l'indice dell'argomento. In caso contrario, argx.ToString() definisce la formattazione.

Se la stringa assegnata a format è "Grazie per aver donato di {0: # # #} lattine di alimenti alla nostra organizzazione." e arg0 è un numero intero con il valore 10, il valore restituito sarà "Grazie per aver donato 10 lattine di alimenti alla nostra organizzazione."

Note per i chiamanti:

Nel.NET Framework 4 e .NET Framework 4.5, quando si crea un'istanza di StringBuilder oggetto chiamando il StringBuilder(Int32, Int32) costruttore, sia la lunghezza e la capacità del StringBuilder istanza può crescere oltre il valore di relativo MaxCapacity proprietà. Questa situazione può verificarsi in particolare quando si chiama il Append e AppendFormat metodi per aggiungere stringhe di piccole dimensioni.

Nell'esempio seguente viene illustrato il AppendFormat metodo.

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
*/

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: