StringBuilder.AppendFormat Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Objektarguments ersetzt.

Überlädt

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(String, Object, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der drei Argumente ersetzt.
AppendFormat(IFormatProvider, String, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines von zwei Argumenten durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(String, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines von zwei Argumenten ersetzt.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der drei Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(IFormatProvider, CompositeFormat, Object[])	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat(String, ReadOnlySpan<Object>)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einer Parameterspanne ersetzt.
AppendFormat(IFormatProvider, String, Object[])	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray mithilfe eines angegebenen Formatanbieters ersetzt.
AppendFormat(IFormatProvider, String, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines einzelnen Arguments mithilfe eines angegebenen Formatanbieters ersetzt.
AppendFormat(String, Object[])	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterarray ersetzt.
AppendFormat(String, Object)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines einzelnen Arguments ersetzt.
AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines entsprechenden Arguments in einem Parameterbereich mithilfe eines angegebenen Formatanbieters ersetzt.
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der Argumente durch einen angegebenen Formatanbieter ersetzt.
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	Fügt die Zeichenfolge an, die durch die Verarbeitung einer zusammengesetzten Formatzeichenfolge zurückgegeben wird, die null oder mehr Formatelemente enthält, an diese Instanz. Jedes Formatelement wird durch die Zeichenfolgendarstellung eines der Argumente durch einen angegebenen Formatanbieter ersetzt.

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, ReadOnlySpan<System::Object ^> args);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, System.Text.CompositeFormat format, ReadOnlySpan<object?> args);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, System.Text.CompositeFormat format, scoped ReadOnlySpan<object?> args);

member this.AppendFormat : IFormatProvider * System.Text.CompositeFormat * ReadOnlySpan<obj> -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As CompositeFormat, args As ReadOnlySpan(Of Object)) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: CompositeFormat

Eine CompositeFormat.

args: ReadOnlySpan<Object>

Eine Spanne von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

Der Index eines Formatelements ist größer oder gleich der Anzahl der angegebenen Argumente.

Gilt für:

.NET 9 und .NET 8

Produkt	Versionen
.NET	8, 9

AppendFormat(String, Object, Object, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public System.Text.StringBuilder AppendFormat (string format, object arg0, object arg1, object arg2);

public System.Text.StringBuilder AppendFormat (string format, object? arg0, object? arg1, object? arg2);

member this.AppendFormat : string * obj * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object, arg1 As Object, arg2 As Object) As StringBuilder

Parameter

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende Objekt.

arg1: Object

Das zweite zu formatierende Objekt.

arg2: Object

Das dritte zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit angefügtem format. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des entsprechenden Objektarguments ersetzt.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 3.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat-Methode veranschaulicht.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'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 = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

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

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

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

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

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      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)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'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

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET Framework, um den Wert eines Objekts in die Textdarstellung zu konvertieren und diese Darstellung in das aktuelle StringBuilder-Objekt einzubetten.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, die arg0 bis arg2entsprechen, die Objekte in der Parameterliste dieser Methode. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Die standard- und benutzerdefinierten Formatzeichenfolgen, die mit Datums- und Uhrzeitwerten verwendet werden, finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen. Informationen zu den standard- und benutzerdefinierten Formatzeichenfolgen, die mit numerischen Werten verwendet werden, finden Sie unter standard numeric format strings und Custom Numeric Format Strings. Informationen zu den standardformatzeichenfolgen, die mit Enumerationen verwendet werden, finden Sie unter Enumeration Format Strings.

arg0, arg1und arg2 die zu formatierenden Objekte darstellen. Jedes Formatelement in format wird je nach Index des Formatelements durch die Zeichenfolgendarstellung von arg0, arg1oder arg2ersetzt. Wenn das Formatelement formatString enthält und das entsprechende Objekt in args die IFormattable Schnittstelle implementiert, definiert argx.ToString(formatString, null) die Formatierung, wobei x der Index des Arguments ist. Andernfalls definiert argx.ToString() die Formatierung.

Wenn die Zeichenfolge, die format zugewiesen ist, "Vielen Dank für Ihre Spende von {0:###}-Dosen an unsere gemeinnützige Organisation" lautet, und arg0 eine ganze Zahl mit dem Wert 10 ist, lautet der Rückgabewert "Vielen Dank für Ihre Spende von 10 Dosen Lebensmittel an unsere gemeinnützige Organisation".

Hinweise für Aufrufer

Wenn Sie das StringBuilder-Objekt instanziieren, indem Sie den StringBuilder(Int32, Int32)-Konstruktor aufrufen, können sowohl die Länge als auch die Kapazität der StringBuilder Instanz in .NET Core und in den Versionen .NET Framework 4.0 und höher über den Wert der MaxCapacity-Eigenschaft hinaus wachsen. Dies kann insbesondere auftreten, wenn Sie die Append(String)- und AppendFormat(String, Object) Methoden aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(IFormatProvider, String, Object, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public System.Text.StringBuilder AppendFormat (IFormatProvider provider, string format, object arg0, object arg1);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, object? arg0, object? arg1);

member this.AppendFormat : IFormatProvider * string * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende Objekt.

arg1: Object

Das zweite zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde. Nach dem Anfügevorgang enthält diese Instanz alle Daten, die vor dem Vorgang vorhanden waren, suffixiert durch eine Kopie von format, wobei eine Formatspezifikation durch die Zeichenfolgendarstellung des entsprechenden Objektarguments ersetzt wird.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 2 (zwei).

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat(IFormatProvider, String, Object, Object)-Methode verwendet, um Zeit- und Temperaturdaten anzuzeigen, die in einem generischen Dictionary<TKey,TValue>-Objekt gespeichert sind. Beachten Sie, dass die Formatzeichenfolge drei Formatelemente enthält, obwohl nur Objekte zum Formatieren vorhanden sind. Dies liegt daran, dass das erste Objekt in der Liste (ein Datums- und Uhrzeitwert) von zwei Formatelementen verwendet wird: Das erste Formatelement zeigt die Uhrzeit an, und das zweite zeigt das Datum an.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Text;

public class Example
{
   public static void Main()
   {
      CultureInfo culture = new CultureInfo("en-US");
      StringBuilder sb = new StringBuilder();
      Dictionary<DateTime, Double> temperatureInfo = new Dictionary<DateTime, Double>(); 
      temperatureInfo.Add(new DateTime(2010, 6, 1, 14, 0, 0), 87.46);
      temperatureInfo.Add(new DateTime(2010, 12, 1, 10, 0, 0), 36.81);

      sb.AppendLine("Temperature Information:\n");
      foreach (var item in temperatureInfo)
      {
         sb.AppendFormat(culture,
                         "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F\n",
                         item.Key, item.Value);
      }
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//       Temperature Information:
//       
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

open System
open System.Collections.Generic
open System.Globalization
open System.Text

let culture = CultureInfo "en-US"
let sb = StringBuilder()
let temperatureInfo = Dictionary<DateTime, Double>()
temperatureInfo.Add(DateTime(2010, 6, 1, 14, 0, 0), 87.46)
temperatureInfo.Add(DateTime(2010, 12, 1, 10, 0, 0), 36.81)

sb.AppendLine "Temperature Information:\n" |> ignore

for item in temperatureInfo do
    sb.AppendFormat(culture, "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F\n", item.Key, item.Value)
    |> ignore

printfn $"{sb}"

// The example displays the following output:
//       Temperature Information:
//
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Imports System.Collections.Generic
Imports System.Globalization
Imports System.Text

Module Example
   Public Sub Main()
      Dim culture As New CultureInfo("en-US")
      Dim sb As New StringBuilder()
      Dim temperatureInfo As New Dictionary(Of Date, Double) 
      temperatureInfo.Add(#6/1/2010 2:00PM#, 87.46)
      temperatureInfo.Add(#12/1/2010 10:00AM#, 36.81)
      
      sb.AppendLine("Temperature Information:").AppendLine()
      For Each item In temperatureInfo
         sb.AppendFormat(culture,
                         "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F",
                         item.Key, item.Value).AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'       Temperature Information:
'       
'       Temperature at  2:00 PM on  6/1/2010:  87.5°F
'       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Hinweise

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, die Objekten in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Der parameter provider gibt eine IFormatProvider Implementierung an, die Formatierungsinformationen für arg0 und arg1bereitstellen kann. provider kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Ein NumberFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0 oder arg1 bereitstellt, wenn es sich um numerische Werte handelt.
Ein DateTimeFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0 oder arg1 bereitstellt, wenn es sich um Datums- und Uhrzeitwerte handelt.
Eine benutzerdefinierte IFormatProvider Implementierung, die Formatierungsinformationen für arg0 und arg1bereitstellt. In der Regel implementiert eine solche Implementierung auch die ICustomFormatter Schnittstelle.

Wenn der parameter providernullist, werden Formatanbieterinformationen aus der aktuellen Kultur abgerufen.

arg0 und arg1 die zu formatierenden Objekte darstellen. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des Objekts ersetzt, das den entsprechenden Index aufweist. Wenn das Formatelement formatString enthält und das entsprechende Argument die IFormattable Schnittstelle implementiert, definiert die ToString(formatString, provider) Methode des Arguments die Formatierung. Andernfalls definiert die ToString() Methode des Arguments die Formatierung.

Hinweise für Aufrufer

IIn .NET Core und in den .NET Framework 4.0- und höheren Versionen, wenn Sie das StringBuilder-Objekt instanziieren, indem Sie den StringBuilder(Int32, Int32)-Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität der StringBuilder Instanz über den Wert der MaxCapacity-Eigenschaft hinaus wachsen. Dies kann insbesondere auftreten, wenn Sie die Append(String)- und AppendFormat(String, Object) Methoden aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(String, Object, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public System.Text.StringBuilder AppendFormat (string format, object arg0, object arg1);

public System.Text.StringBuilder AppendFormat (string format, object? arg0, object? arg1);

member this.AppendFormat : string * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object, arg1 As Object) As StringBuilder

Parameter

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende Objekt.

arg1: Object

Das zweite zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit angefügtem format. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des entsprechenden Objektarguments ersetzt.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 2.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat-Methode veranschaulicht.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'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 = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

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

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

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

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

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      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)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'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

Hinweise

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, die arg0 und arg1entsprechen, die beiden Objekte in der Parameterliste dieser Methode. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

arg0 und arg1 die zu formatierenden Objekte darstellen. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung von arg0 oder arg1ersetzt. Wenn das Formatelement formatString enthält und das entsprechende Objekt die IFormattable Schnittstelle implementiert, definiert argx.ToString(formatString, provider) die Formatierung, wobei x der Index des Arguments ist. Andernfalls definiert argx.ToString() die Formatierung.

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(IFormatProvider, String, Object, Object, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public System.Text.StringBuilder AppendFormat (IFormatProvider provider, string format, object arg0, object arg1, object arg2);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, object? arg0, object? arg1, object? arg2);

member this.AppendFormat : IFormatProvider * string * obj * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object, arg2 As Object) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende Objekt.

arg1: Object

Das zweite zu formatierende Objekt.

arg2: Object

Das dritte zu formatierende Objekt.

Gibt zurück

StringBuilder

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 3 (drei).

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat(IFormatProvider, String, Object, Object, Object)-Methode verwendet, um das Ergebnis eines booleschen And Vorgangs mit ganzzahligen Werten zu veranschaulichen. Beachten Sie, dass die Formatzeichenfolge sechs Formatelemente enthält, die Methode jedoch nur drei Elemente in der Argumentliste enthält, da jedes Element auf zwei verschiedene Arten formatiert ist.

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

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      CultureInfo culture = CultureInfo.CreateSpecificCulture("fr-FR");
      StringBuilder sb = new StringBuilder();
      string formatString = "    {0,12:N0} ({0,8:X8})\n" +
                            "And {1,12:N0} ({1,8:X8})\n" +
                            "  = {2,12:N0} ({2,8:X8})\n";
      for (int ctr = 0; ctr <= 2; ctr++) {
         int value1 = rnd.Next();
         int value2 = rnd.Next();
         sb.AppendFormat(culture, formatString,
                         value1, value2, value1 & value2).
                         AppendLine();
      }
      Console.WriteLine(sb.ToString());
   }
}
// The example displays output like the following:
//           1 984 112 195 (76432643)
//       And 1 179 778 511 (4651FDCF)
//         = 1 178 674 243 (46412443)
//
//           2 034 813 710 (7948CB0E)
//       And  569 333 976 (21EF58D8)
//         =  558 385 160 (21484808)
//
//            126 717 735 (078D8F27)
//       And 1 830 715 973 (6D1E8245)
//         =   84 705 797 (050C8205)

open System
open System.Globalization
open System.Text

let rnd = Random()
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
let sb = StringBuilder()

let formatString =
    "    {0,12:N0} ({0,8:X8})\nAnd {1,12:N0} ({1,8:X8})\n  = {2,12:N0} ({2,8:X8})\n"

for _ = 0 to 2 do
    let value1 = rnd.Next()
    let value2 = rnd.Next()

    sb
        .AppendFormat(culture, formatString, value1, value2, value1 &&& value2)
        .AppendLine()
    |> ignore

printfn $"{sb}"

// The example displays output like the following:
//           1 984 112 195 (76432643)
//       And 1 179 778 511 (4651FDCF)
//         = 1 178 674 243 (46412443)
//
//           2 034 813 710 (7948CB0E)
//       And  569 333 976 (21EF58D8)
//         =  558 385 160 (21484808)
//
//            126 717 735 (078D8F27)
//       And 1 830 715 973 (6D1E8245)
//         =   84 705 797 (050C8205)

Imports System.Globalization
Imports System.Text

Public Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("fr-FR")
      Dim sb As New StringBuilder()
      Dim formatString As String = "    {0,12:N0} ({0,8:X8})" + vbCrLf +
                                   "And {1,12:N0} ({1,8:X8})" + vbCrLf +
                                   "  = {2,12:N0} ({2,8:X8})" + vbCrLf
      For ctr As Integer = 0 To 2
         Dim value1 As Integer = rnd.Next()
         Dim value2 As Integer = rnd.Next()
         sb.AppendFormat(culture, formatString,
                         value1, value2, value1 And value2).AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'           1 984 112 195 (76432643)
'       And 1 179 778 511 (4651FDCF)
'         = 1 178 674 243 (46412443)
'
'           2 034 813 710 (7948CB0E)
'       And  569 333 976 (21EF58D8)
'         =  558 385 160 (21484808)
'
'            126 717 735 (078D8F27)
'       And 1 830 715 973 (6D1E8245)
'         =   84 705 797 (050C8205)

Hinweise

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Der parameter provider gibt eine IFormatProvider Implementierung an, die Formatierungsinformationen für arg0 und arg1bereitstellen kann. provider kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Ein NumberFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0 oder arg1 bereitstellt, wenn es sich um numerische Werte handelt.
Ein DateTimeFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0, arg1oder arg2 bereitstellt, wenn es sich um Datums- und Uhrzeitwerte handelt.
Eine benutzerdefinierte IFormatProvider Implementierung, die Formatierungsinformationen für arg0, arg1und arg2bereitstellt. In der Regel implementiert eine solche Implementierung auch die ICustomFormatter Schnittstelle.

Wenn der parameter providernullist, werden Formatanbieterinformationen aus der aktuellen Kultur abgerufen.

arg0, arg1und arg2 die zu formatierenden Objekte darstellen. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des Objekts ersetzt, das den entsprechenden Index aufweist. Wenn das Formatelement formatString enthält und das entsprechende Argument die IFormattable Schnittstelle implementiert, definiert die ToString(formatString, provider) Methode des Arguments die Formatierung. Andernfalls definiert die ToString() Methode des Arguments die Formatierung.

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, ... cli::array <System::Object ^> ^ args);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, System.Text.CompositeFormat format, params object?[] args);

member this.AppendFormat : IFormatProvider * System.Text.CompositeFormat * obj[] -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As CompositeFormat, ParamArray args As Object()) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: CompositeFormat

Eine CompositeFormat.

args: Object[]

Ein Array von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format oder args ist null.

FormatException

Der Index eines Formatelements ist größer oder gleich der Anzahl der angegebenen Argumente.

Gilt für:

.NET 9 und .NET 8

Produkt	Versionen
.NET	8, 9

AppendFormat(String, ReadOnlySpan<Object>)

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, ReadOnlySpan<System::Object ^> args);

public System.Text.StringBuilder AppendFormat (string format, scoped ReadOnlySpan<object?> args);

member this.AppendFormat : string * ReadOnlySpan<obj> -> System.Text.StringBuilder

Public Function AppendFormat (format As String, args As ReadOnlySpan(Of Object)) As StringBuilder

Parameter

format: String

Eine zusammengesetzte Formatzeichenfolge.

args: ReadOnlySpan<Object>

Eine Spanne von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer oder gleich der Länge der args Spanne.

Gilt für:

.NET 9

Produkt	Versionen
.NET	9

AppendFormat(IFormatProvider, String, Object[])

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, ... cli::array <System::Object ^> ^ args);

public System.Text.StringBuilder AppendFormat (IFormatProvider provider, string format, params object[] args);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, params object?[] args);

member this.AppendFormat : IFormatProvider * string * obj[] -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, ParamArray args As Object()) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: String

Eine zusammengesetzte Formatzeichenfolge.

args: Object[]

Ein Array von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer oder gleich der Länge des args Arrays.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat-Methode veranschaulicht.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'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 = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

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

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

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

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

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      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)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'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

Im folgenden Beispiel wird eine benutzerdefinierte IFormatProvider Implementierung namens CustomerFormatter definiert, die eine 10-stellige Kundennummer mit Bindestrichen nach der vierten und siebten Ziffer formatiert. Sie wird an die StringBuilder.AppendFormat(IFormatProvider, String, Object[])-Methode übergeben, um eine Zeichenfolge zu erstellen, die die formatierte Kundennummer und den Kundennamen enthält.

using System;
using System.Text;

public class Customer
{
   private string custName;
   private int custNumber;
   
   public Customer(string name, int number)
   {
      this.custName = name;
      this.custNumber = number;
   }
   
   public string Name
   {
      get { return this.custName; }
   }
   
   public int CustomerNumber
   {
      get { return this.custNumber; }
   }
}

public class CustomerNumberFormatter : IFormatProvider, ICustomFormatter
{   
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(ICustomFormatter))
         return this;
      return null;
   }
   
   public string Format(string format, object arg, IFormatProvider provider)
   {
      if (arg is Int32)
      {
         string custNumber = ((int) arg).ToString("D10");
         return custNumber.Substring(0, 4) + "-" + custNumber.Substring(4, 3) + 
                "-" + custNumber.Substring(7, 3);
      }
      else
      {
         return null;
      }
   }                   
}

public class Example
{
   public static void Main()
   {
      Customer customer = new Customer("A Plus Software", 903654);
      StringBuilder sb = new StringBuilder();
      sb.AppendFormat(new CustomerNumberFormatter(), "{0}: {1}", 
                      customer.CustomerNumber, customer.Name);
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//      0000-903-654: A Plus Software

open System
open System.Text

type Customer(name: string, number: int) =
    member _.Name = name
    member _.CustomerNumber = number

type CustomerNumberFormatter() =
    interface IFormatProvider with
        member this.GetFormat(formatType) =
            if formatType = typeof<ICustomFormatter> then this else null

    interface ICustomFormatter with
        member _.Format(_, arg, _) =
            match arg with
            | :? int as i ->
                let custNumber = i.ToString "D10"
                $"{custNumber.Substring(0, 4)}-{custNumber.Substring(4, 3)}-{custNumber.Substring(7, 3)}"
            | _ -> null

let customer = Customer("A Plus Software", 903654)
let sb = StringBuilder()

sb.AppendFormat(CustomerNumberFormatter(), "{0}: {1}", customer.CustomerNumber, customer.Name)
|> ignore

printfn $"{sb}"

// The example displays the following output:
//      0000-903-654: A Plus Software

Imports System.Text

Public Class Customer
   Private custName As String
   Private custNumber As Integer
   
   Public Sub New(name As String, number As Integer)
      custName = name
      custNumber = number
   End Sub
   
   Public ReadOnly Property Name As String
      Get
         Return Me.custName
      End Get
   End Property
   
   Public ReadOnly Property CustomerNumber As Integer
      Get
         Return Me.custNumber
      End Get
   End Property
End Class

Public Class CustomerNumberFormatter 
   Implements IFormatProvider, ICustomFormatter
   
   Public Function GetFormat(formatType As Type) As Object _
                   Implements IFormatProvider.GetFormat
      If formatType Is GetType(ICustomFormatter) Then
         Return Me
      End If
      Return Nothing
   End Function
   
   Public Function Format(fmt As String, arg As Object, provider As IFormatProvider) As String _
                   Implements ICustomFormatter.Format
      If typeof arg Is Int32 Then
         Dim custNumber As String = CInt(arg).ToString("D10")
         Return custNumber.Substring(0, 4) + "-" + custNumber.SubString(4, 3) + _
                "-" + custNumber.Substring(7, 3)
      Else
         Return Nothing
      End If
   End Function                   
End Class

Module Example
   Public Sub Main()
      Dim customer As New Customer("A Plus Software", 903654)
      Dim sb As New StringBuilder()
      sb.AppendFormat(New CustomerNumberFormatter, "{0}: {1}", _
                      customer.CustomerNumber, customer.Name)
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'      0000-903-654: A Plus Software

Hinweise

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Der parameter provider gibt eine IFormatProvider Implementierung an, die Formatierungsinformationen für die Objekte in argsbereitstellen kann. provider kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Ein NumberFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für numerische Werte in argsbereitstellt.
Ein DateTimeFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für Datums- und Uhrzeitwerte in argsbereitstellt.
Eine benutzerdefinierte IFormatProvider Implementierung, die Formatierungsinformationen für mindestens ein Objekt in argsbereitstellt. In der Regel implementiert eine solche Implementierung auch die ICustomFormatter Schnittstelle. Im zweiten Beispiel im nächsten Abschnitt wird ein StringBuilder.AppendFormat(IFormatProvider, String, Object[]) Methodenaufruf mit einer benutzerdefinierten IFormatProvider Implementierung veranschaulicht.

Wenn der parameter providernullist, werden Formatanbieterinformationen aus der aktuellen Kultur abgerufen.

args stellt die zu formatierenden Objekte dar. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des entsprechenden Objekts in argsersetzt. Wenn das Formatelement formatString enthält und das entsprechende Objekt in args die IFormattable Schnittstelle implementiert, definiert args[index].ToString(formatString, provider) die Formatierung. Andernfalls definiert args[index].ToString() die Formatierung.

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(IFormatProvider, String, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0);

public System.Text.StringBuilder AppendFormat (IFormatProvider provider, string format, object arg0);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, object? arg0);

member this.AppendFormat : IFormatProvider * string * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Das zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde. Nach dem Anfügevorgang enthält diese Instanz alle Daten, die vor dem Vorgang vorhanden waren, suffixed by a copy of format in which any format specification is replaced by the string representation of arg0.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 1 (1).

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im Folgenden finden Sie zwei Aufrufe der AppendFormat(IFormatProvider, String, Object)-Methode. Beide verwenden die Formatierungskonventionen des English-United Königreichs (en-GB) Kultur. Im ersten Schritt wird die Zeichenfolgendarstellung einer Decimal Wertwährung in eine Ergebniszeichenfolge eingefügt. Die zweite fügt einen DateTime Wert an zwei Stellen in einer Ergebniszeichenfolge ein, die erste enthält nur die kurze Datumszeichenfolge und die zweite die kurze Zeitzeichenfolge.

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

public class Example
{
   public static void Main()
   {
      StringBuilder sb = new StringBuilder();
      Decimal value = 16.95m;
      CultureInfo enGB = CultureInfo.CreateSpecificCulture("en-GB");
      DateTime dateToday = DateTime.Now;
      sb.AppendFormat(enGB, "Final Price: {0:C2}", value);
      sb.AppendLine();
      sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday);
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//       Final Price: £16.95
//       Date and Time: 01/10/2014 at 10:22

open System
open System.Globalization
open System.Text

let sb = StringBuilder()
let value = 16.95m
let enGB = CultureInfo.CreateSpecificCulture "en-GB"
let dateToday = DateTime.Now
sb.AppendFormat(enGB, "Final Price: {0:C2}", value) |> ignore
sb.AppendLine() |> ignore
sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday) |> ignore
printfn $"{sb}"

// The example displays the following output:
//       Final Price: £16.95
//       Date and Time: 01/10/2014 at 10:22

Imports System.Globalization
Imports System.Text

Module Example
   Public Sub Main()
      Dim sb As New StringBuilder()
      Dim value As Decimal = 16.95d
      Dim enGB As CultureInfo = CultureInfo.CreateSpecificCulture("en-GB")
      Dim dateToday As DateTime = Date.Now
      sb.AppendFormat(enGB, "Final Price: {0:C2}", value)
      sb.AppendLine()
      sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday)
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays output like the following:
'       Final Price: £16.95
'       Date and Time: 01/10/2014 at 10:22

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET Framework, um den Wert von arg0 in die Textdarstellung zu konvertieren und diese Darstellung in das aktuelle StringBuilder-Objekt einzubetten.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, gemischt sind. Der Index jedes Formatelements muss null (0) sein, da diese Methode eine Argumentliste mit einem einzelnen Argument enthält. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung von arg0.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Da in diesem Fall die AppendFormat(IFormatProvider, String, Object)-Methode ein einzelnes Argument in der Argumentliste aufweist, muss der Wert Index immer 0 sein. Wenn dies nicht der Fehler ist, wird eine FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Der parameter provider gibt eine IFormatProvider Implementierung an, die Formatierungsinformationen für die Objekte in argsbereitstellen kann. provider kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Ein NumberFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0 bereitstellt, wenn es sich um einen numerischen Wert handelt.
Ein DateTimeFormatInfo-Objekt, das kulturspezifische Formatierungsinformationen für arg0 bereitstellt, wenn es sich um einen Datums- und Uhrzeitwert handelt.
Eine benutzerdefinierte IFormatProvider Implementierung, die Formatierungsinformationen für arg0bereitstellt. In der Regel implementiert eine solche Implementierung auch die ICustomFormatter Schnittstelle.

Wenn der parameter providernullist, werden Formatierungsinformationen aus der aktuellen Kultur abgerufen.

arg0 stellt das zu formatierende Objekt dar. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung von arg0ersetzt. Wenn das Formatelement formatString enthält und arg0 die IFormattable Schnittstelle implementiert, definiert arg0.ToString(formatString, provider) die Formatierung. Andernfalls definiert arg0.ToString() die Formatierung.

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(String, Object[])

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, ... cli::array <System::Object ^> ^ args);

public System.Text.StringBuilder AppendFormat (string format, params object[] args);

public System.Text.StringBuilder AppendFormat (string format, params object?[] args);

member this.AppendFormat : string * obj[] -> System.Text.StringBuilder

Public Function AppendFormat (format As String, ParamArray args As Object()) As StringBuilder

Parameter

format: String

Eine zusammengesetzte Formatzeichenfolge.

args: Object[]

Ein Array von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit angefügtem format. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung des entsprechenden Objektarguments ersetzt.

Ausnahmen

ArgumentNullException

format oder args ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer oder gleich der Länge des args Arrays.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat-Methode veranschaulicht.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'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 = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

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

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

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

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

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      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)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'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

Hinweise

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(String, Object)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0);

public System.Text.StringBuilder AppendFormat (string format, object arg0);

public System.Text.StringBuilder AppendFormat (string format, object? arg0);

member this.AppendFormat : string * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object) As StringBuilder

Parameter

format: String

Eine zusammengesetzte Formatzeichenfolge.

arg0: Object

Ein zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit angefügtem format. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung von arg0ersetzt.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich 1.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

Beispiele

Im folgenden Beispiel wird die AppendFormat-Methode veranschaulicht.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'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 = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

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

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

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

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

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      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)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'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

Hinweise

Der format-Parameter besteht aus null oder mehr Textläufen, die mit null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, gemischt sind. Der Index der Formatelemente muss 0 sein, um arg0zu entsprechen, das einzelne Objekt in der Parameterliste dieser Methode. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung von arg0.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objekt`null`ist, wird das Formatelement durch String.Emptyersetzt. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine standard- oder benutzerdefinierte Formatzeichenfolge, die vom Parameter unterstützt wird.

Hinweis

arg0 stellt das zu formatierende Objekt dar. Jedes Formatelement in format wird durch die Zeichenfolgendarstellung von arg0ersetzt. Wenn das Formatelement formatString enthält und arg0 die IFormattable Schnittstelle implementiert, definiert arg0.ToString(formatString, null) die Formatierung. Andernfalls definiert arg0.ToString() die Formatierung.

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, ReadOnlySpan<System::Object ^> args);

public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, scoped ReadOnlySpan<object?> args);

member this.AppendFormat : IFormatProvider * string * ReadOnlySpan<obj> -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, args As ReadOnlySpan(Of Object)) As StringBuilder

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: String

Eine zusammengesetzte Formatzeichenfolge.

args: ReadOnlySpan<Object>

Eine Spanne von Objekten, die formatiert werden sollen.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

ArgumentOutOfRangeException

Die Länge der erweiterten Zeichenfolge würde MaxCapacityüberschreiten.

FormatException

format ist ungültig.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer oder gleich der Länge der args Spanne.

Gilt für:

.NET 9

Produkt	Versionen
.NET	9

AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
generic <typename TArg0, typename TArg1, typename TArg2>
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0, TArg1 arg1, TArg2 arg2);

public System.Text.StringBuilder AppendFormat<TArg0,TArg1,TArg2> (IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0, TArg1 arg1, TArg2 arg2);

member this.AppendFormat : IFormatProvider * System.Text.CompositeFormat * 'TArg0 * 'TArg1 * 'TArg2 -> System.Text.StringBuilder

Public Function AppendFormat(Of TArg0, TArg1, TArg2) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0, arg1 As TArg1, arg2 As TArg2) As StringBuilder

Typparameter

TArg0

Der Typ des ersten zu formatierenden Objekts.

TArg1

Der Typ des zweiten zu formatierenden Objekts.

TArg2

Der Typ des dritten zu formatierenden Objekts.

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: CompositeFormat

Eine CompositeFormat.

arg0: TArg0

Das erste zu formatierende Objekt.

arg1: TArg1

Das zweite zu formatierende Objekt.

arg2: TArg2

Das dritte zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

Der Index eines Formatelements ist größer oder gleich der Anzahl der angegebenen Argumente.

Gilt für:

.NET 9 und .NET 8

Produkt	Versionen
.NET	8, 9

AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
generic <typename TArg0, typename TArg1>
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0, TArg1 arg1);

public System.Text.StringBuilder AppendFormat<TArg0,TArg1> (IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0, TArg1 arg1);

member this.AppendFormat : IFormatProvider * System.Text.CompositeFormat * 'TArg0 * 'TArg1 -> System.Text.StringBuilder

Public Function AppendFormat(Of TArg0, TArg1) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0, arg1 As TArg1) As StringBuilder

Typparameter

TArg0

Der Typ des ersten zu formatierenden Objekts.

TArg1

Der Typ des zweiten zu formatierenden Objekts.

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: CompositeFormat

Eine CompositeFormat.

arg0: TArg0

Das erste zu formatierende Objekt.

arg1: TArg1

Das zweite zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

Der Index eines Formatelements ist größer oder gleich der Anzahl der angegebenen Argumente.

Gilt für:

.NET 9 und .NET 8

Produkt	Versionen
.NET	8, 9

AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

public:
generic <typename TArg0>
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::Text::CompositeFormat ^ format, TArg0 arg0);

public System.Text.StringBuilder AppendFormat<TArg0> (IFormatProvider? provider, System.Text.CompositeFormat format, TArg0 arg0);

member this.AppendFormat : IFormatProvider * System.Text.CompositeFormat * 'TArg0 -> System.Text.StringBuilder

Public Function AppendFormat(Of TArg0) (provider As IFormatProvider, format As CompositeFormat, arg0 As TArg0) As StringBuilder

Typparameter

TArg0

Der Typ des ersten zu formatierenden Objekts.

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

format: CompositeFormat

Eine CompositeFormat.

arg0: TArg0

Das erste zu formatierende Objekt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentNullException

format ist null.

FormatException

Der Index eines Formatelements ist größer oder gleich der Anzahl der angegebenen Argumente.

Gilt für:

.NET 9 und .NET 8

Produkt	Versionen
.NET	8, 9

Die Zukunft gehört Ihnen

Freigeben über

StringBuilder.AppendFormat Methode

Definition

Überlädt

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

AppendFormat(String, Object, Object, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(IFormatProvider, String, Object, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(String, Object, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(IFormatProvider, String, Object, Object, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Parameter

Gibt zurück

Ausnahmen

Gilt für:

AppendFormat(String, ReadOnlySpan<Object>)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

AppendFormat(IFormatProvider, String, Object[])

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(IFormatProvider, String, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendFormat(String, Object[])

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise