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)

 

Data di pubblicazione: ottobre 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 un singolo argomento.

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

public StringBuilder AppendFormat(
	string format,
	object arg0
)

Parametri

format
Type: System.String

Stringa in formato composito (vedere la sezione Note).

arg0
Type: System.Object

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 di arg0.

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 1 (uno).

ArgumentOutOfRangeException

La lunghezza della stringa espansa supererebbe MaxCapacity.

This method uses the composite formatting feature of the .NET Framework to convert the value of an object to its text representation and embed that representation in the current T:System.Text.StringBuilder object.

The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items. The index of the format items must be 0, to correspond to arg0, the single object in the parameter list of this method. The formatting process replaces each format item with the string representation of arg0.

The syntax of a format item is as follows:

{index[,length][:formatString]}

Elements in square brackets are optional. The following table describes each element.

Element

Description

index

The zero-based position in the parameter list of the object to be formatted. If the object specified by index is null, the format item is replaced by F:System.String.Empty. If there is no parameter in the index position, a T:System.FormatException is thrown.

,length

The minimum number of characters in the string representation of the parameter. If positive, the parameter is right-aligned; if negative, it is left-aligned.

:formatString

A standard or custom format string that is supported by the parameter.

System_CAPS_noteNota

For the standard and custom format strings used with date and time values, see Standard Date and Time Format Strings and Custom Date and Time Format Strings. For the standard and custom format strings used with numeric values, see Standard Numeric Format Strings and Custom Numeric Format Strings. For the standard format strings used with enumerations, see Enumeration Format Strings.

arg0 represents the object to be formatted. Each format item in format is replaced with the string representation of arg0. If the format item includes formatString and arg0 implements the IFormattable interface, then arg0.ToString(formatString, null) defines the formatting. Otherwise, arg0.ToString() defines the formatting.

If the string assigned to format is "Thank you for your donation of {0:####} cans of food to our charitable organization." and arg0 is an integer with the value 10, the return value will be "Thank you for your donation of 10 cans of food to our charitable organization."

Note per i chiamanti:

In thenet_v40_short and the net_v45, when you instantiate the T:System.Text.StringBuilder object by calling the M:System.Text.StringBuilder.#ctor(System.Int32,System.Int32) constructor, both the length and the capacity of the T:System.Text.StringBuilder instance can grow beyond the value of its P:System.Text.StringBuilder.MaxCapacity property. This can occur particularly when you call the M:System.Text.StringBuilder.Append(System.String) and M:System.Text.StringBuilder.AppendFormat(System.String,System.Object) methods to append small strings.

The following example demonstrates the Overload:System.Text.StringBuilder.AppendFormat method.

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: