Udostępnij za pośrednictwem


StringBuilder.AppendFormat Metoda

Definicja

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument obiektu.

Przeciążenia

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

AppendFormat(String, Object, Object, Object)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z trzech argumentów.

AppendFormat(IFormatProvider, String, Object, Object)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów przy użyciu określonego dostawcy formatu.

AppendFormat(String, Object, Object)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów.

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

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący jeden z trzech argumentów przy użyciu określonego dostawcy formatu.

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

AppendFormat(String, ReadOnlySpan<Object>)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów.

AppendFormat(IFormatProvider, String, Object[])

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów przy użyciu określonego dostawcy formatu.

AppendFormat(IFormatProvider, String, Object)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu przy użyciu określonego dostawcy formatu.

AppendFormat(String, Object[])

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów.

AppendFormat(String, Object)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu.

AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów przy użyciu określonego dostawcy formatu.

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

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

args
ReadOnlySpan<Object>

Zakres obiektów do formatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Indeks elementu formatu jest większy lub równy liczbie podanych argumentów.

Dotyczy

AppendFormat(String, Object, Object, Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z trzech argumentów.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do sformatowania.

arg1
Object

Drugi obiekt do sformatowania.

arg2
Object

Trzeci obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia z dołączonym format. Każdy element formatu w format jest zastępowany przez reprezentację ciągu odpowiadającego argumentu obiektu.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy 3.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie pokazano metodę AppendFormat.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu zmieszanego z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają arg0 za pośrednictwem arg2, obiektów na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

arg0, arg1i arg2 reprezentują obiekty do sformatowania. Każdy element formatu w format jest zastępowany reprezentacją ciągu arg0, arg1lub arg2, w zależności od indeksu elementu formatu. Jeśli element formatu zawiera formatString i odpowiedni obiekt w args implementuje interfejs IFormattable, argx.ToString(formatString, null) definiuje formatowanie, gdzie x jest indeksem argumentu. W przeciwnym razie argx.ToString() definiuje formatowanie.

Jeśli ciąg przypisany do format to "Dziękujemy za darowiznę {0:#####} pach żywności dla naszej organizacji charytatywnej"., a arg0 jest liczbą całkowitą o wartości 10, wartość zwrotna będzie "Dziękuję za darowiznę 10 pach żywności dla naszej organizacji charytatywnej"."

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(IFormatProvider, String, Object, Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do sformatowania.

arg1
Object

Drugi obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania. Po operacji dołączania to wystąpienie zawiera wszystkie dane, które istniały przed operacją, sufiks przez kopię format, gdzie każda specyfikacja formatu jest zastępowana przez reprezentację ciągu odpowiedniego argumentu obiektu.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy 2 (dwa).

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie użyto metody AppendFormat(IFormatProvider, String, Object, Object) do wyświetlania danych dotyczących czasu i temperatury przechowywanych w ogólnym obiekcie Dictionary<TKey,TValue>. Należy pamiętać, że ciąg formatu ma trzy elementy formatu, chociaż istnieją tylko obiekty do formatowania. Jest to spowodowane tym, że pierwszy obiekt na liście (wartość daty i godziny) jest używany przez dwa elementy formatu: pierwszy element formatu wyświetla godzinę, a drugi wyświetla datę.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektom na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

Parametr provider określa implementację IFormatProvider, która może dostarczać informacje o formatowaniu arg0 i arg1. provider mogą być następujące:

  • Obiekt CultureInfo, który udostępnia informacje o formatowaniu specyficznym dla kultury.

  • Obiekt NumberFormatInfo, który zapewnia informacje o formatowaniu specyficznym dla kultury dla arg0 lub arg1, jeśli są wartościami liczbowymi.

  • Obiekt DateTimeFormatInfo, który udostępnia informacje dotyczące formatowania specyficzne dla kultury dla arg0 lub arg1, jeśli są to wartości daty i godziny.

  • Niestandardowa implementacja IFormatProvider, która udostępnia informacje o formatowaniu arg0 i arg1. Zazwyczaj taka implementacja implementuje również interfejs ICustomFormatter.

Jeśli parametr provider jest null, informacje o dostawcy formatu są uzyskiwane z bieżącej kultury.

arg0 i arg1 reprezentują obiekty do sformatowania. Każdy element formatu w format jest zastępowany ciągiem reprezentującym obiekt, który ma odpowiedni indeks. Jeśli element formatu zawiera formatString, a odpowiadający mu argument implementuje interfejs IFormattable, metoda ToString(formatString, provider) argumentu definiuje formatowanie. W przeciwnym razie metoda ToString() argumentu definiuje formatowanie.

Uwagi dotyczące wywoływania

Po utworzeniu wystąpienia obiektu StringBuilder platformy .NET Core i w programie .NET Framework 4.0 i nowszych wersjach wywoływanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(String, Object, Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu jednego z dwóch argumentów.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do sformatowania.

arg1
Object

Drugi obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia z dołączonym format. Każdy element formatu w format jest zastępowany przez reprezentację ciągu odpowiadającego argumentu obiektu.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy 2.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie pokazano metodę AppendFormat.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają arg0 i arg1, dwa obiekty na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

arg0 i arg1 reprezentują obiekty do sformatowania. Każdy element formatu w format jest zastępowany reprezentacją ciągu arg0 lub arg1. Jeśli element formatu zawiera formatString i odpowiedni obiekt implementuje interfejs IFormattable, argx.ToString(formatString, provider) definiuje formatowanie, gdzie x jest indeksem argumentu. W przeciwnym razie argx.ToString() definiuje formatowanie.

Jeśli ciąg przypisany do format to "Dziękujemy za darowiznę {0:#####} pach żywności dla naszej organizacji charytatywnej"., a arg0 jest liczbą całkowitą o wartości 10, wartość zwrotna będzie "Dziękuję za darowiznę 10 pach żywności dla naszej organizacji charytatywnej"."

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

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

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący jeden z trzech argumentów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do sformatowania.

arg1
Object

Drugi obiekt do sformatowania.

arg2
Object

Trzeci obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania. Po operacji dołączania to wystąpienie zawiera wszystkie dane, które istniały przed operacją, sufiks przez kopię format, gdzie każda specyfikacja formatu jest zastępowana przez reprezentację ciągu odpowiedniego argumentu obiektu.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy 3 (trzy).

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie użyto metody AppendFormat(IFormatProvider, String, Object, Object, Object), aby zilustrować wynik operacji And logicznej z wartościami całkowitymi. Należy pamiętać, że ciąg formatu zawiera sześć elementów formatu, ale metoda ma tylko trzy elementy na liście argumentów, ponieważ każdy element jest sformatowany na dwa różne sposoby.

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)

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektom na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

Parametr provider określa implementację IFormatProvider, która może dostarczać informacje o formatowaniu arg0 i arg1. provider mogą być następujące:

  • Obiekt CultureInfo, który udostępnia informacje o formatowaniu specyficznym dla kultury.

  • Obiekt NumberFormatInfo, który zapewnia informacje o formatowaniu specyficznym dla kultury dla arg0 lub arg1, jeśli są wartościami liczbowymi.

  • Obiekt DateTimeFormatInfo, który udostępnia informacje o formatowaniu specyficznym dla kultury dla arg0, arg1lub arg2, jeśli są wartościami daty i godziny.

  • Niestandardowa implementacja IFormatProvider, która udostępnia informacje o formatowaniu arg0, arg1i arg2. Zazwyczaj taka implementacja implementuje również interfejs ICustomFormatter.

Jeśli parametr provider jest null, informacje o dostawcy formatu są uzyskiwane z bieżącej kultury.

arg0, arg1i arg2 reprezentują obiekty do sformatowania. Każdy element formatu w format jest zastępowany ciągiem reprezentującym obiekt, który ma odpowiedni indeks. Jeśli element formatu zawiera formatString, a odpowiadający mu argument implementuje interfejs IFormattable, metoda ToString(formatString, provider) argumentu definiuje formatowanie. W przeciwnym razie metoda ToString() argumentu definiuje formatowanie.

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

args
Object[]

Tablica obiektów do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format lub args jest null.

Indeks elementu formatu jest większy lub równy liczbie podanych argumentów.

Dotyczy

AppendFormat(String, ReadOnlySpan<Object>)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów.

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

Parametry

format
String

Ciąg formatu złożonego.

args
ReadOnlySpan<Object>

Zakres obiektów do formatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości zakresu args.

Dotyczy

AppendFormat(IFormatProvider, String, Object[])

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

format
String

Ciąg formatu złożonego.

args
Object[]

Tablica obiektów do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania. Po operacji dołączania to wystąpienie zawiera wszystkie dane, które istniały przed operacją, sufiks przez kopię format, gdzie każda specyfikacja formatu jest zastępowana przez reprezentację ciągu odpowiedniego argumentu obiektu.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości tablicy args.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie pokazano metodę AppendFormat.

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

W poniższym przykładzie zdefiniowano niestandardową implementację IFormatProvider o nazwie CustomerFormatter, która formatuje 10-cyfrowy numer klienta z łącznikami po czwartych i siódmych cyfrach. Jest on przekazywany do metody StringBuilder.AppendFormat(IFormatProvider, String, Object[]) w celu utworzenia ciągu zawierającego sformatowany numer klienta i nazwę klienta.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektom na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

Parametr provider określa implementację IFormatProvider, która może dostarczać informacje o formatowaniu obiektów w args. provider mogą być następujące:

Jeśli parametr provider jest null, informacje o dostawcy formatu są uzyskiwane z bieżącej kultury.

args reprezentuje obiekty do sformatowania. Każdy element formatu w format jest zastępowany ciągiem reprezentującym odpowiedni obiekt w args. Jeśli element formatu zawiera formatString i odpowiedni obiekt w args implementuje interfejs IFormattable, args[index].ToString(formatString, provider) definiuje formatowanie. W przeciwnym razie args[index].ToString() definiuje formatowanie.

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(IFormatProvider, String, Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

format
String

Ciąg formatu złożonego.

arg0
Object

Obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania. Po operacji dołączania to wystąpienie zawiera wszystkie dane, które istniały przed operacją, sufiksem kopii format, w której każda specyfikacja formatu jest zastępowana przez reprezentację ciągu arg0.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy jednemu (1).

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

Poniżej przedstawiono dwa wywołania metody AppendFormat(IFormatProvider, String, Object). Obie używają konwencji formatowania kultury English-United Kingdom (en-GB). Pierwszy wstawia ciąg reprezentujący walutę wartości Decimal w ciągu wynikowym. Drugi wstawia wartość DateTime w dwóch miejscach w ciągu wynikowym, pierwszy zawierający tylko ciąg daty krótkiej i drugi ciąg czasu.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość arg0 na jej reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych nazywanych elementami formatu. Indeks każdego elementu formatu musi mieć wartość zero (0), ponieważ ta metoda zawiera listę argumentów z pojedynczym argumentem. Proces formatowania zastępuje każdy element formatu reprezentacją ciągu arg0.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. W tym przypadku, ponieważ metoda AppendFormat(IFormatProvider, String, Object) ma jeden argument na liście argumentów, wartość indeksu musi zawsze wynosić 0. Jeśli tak nie jest, zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

Parametr provider określa implementację IFormatProvider, która może dostarczać informacje o formatowaniu obiektów w args. provider mogą być następujące:

  • Obiekt CultureInfo, który udostępnia informacje o formatowaniu specyficznym dla kultury.

  • Obiekt NumberFormatInfo, który udostępnia informacje o formatowaniu specyficznym dla kultury dla arg0, jeśli jest to wartość liczbowa.

  • Obiekt DateTimeFormatInfo, który udostępnia informacje dotyczące formatowania specyficzne dla kultury dla arg0, jeśli jest to wartość daty i godziny.

  • Niestandardowa implementacja IFormatProvider, która udostępnia informacje o formatowaniu arg0. Zazwyczaj taka implementacja implementuje również interfejs ICustomFormatter.

Jeśli parametr provider jest null, informacje o formatowaniu są uzyskiwane z bieżącej kultury.

arg0 reprezentuje obiekt do sformatowania. Każdy element formatu w format jest zastępowany reprezentacją ciągu arg0. Jeśli element formatu zawiera formatString i arg0 implementuje interfejs IFormattable, arg0.ToString(formatString, provider) definiuje formatowanie. W przeciwnym razie arg0.ToString() definiuje formatowanie.

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(String, Object[])

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w tablicy parametrów.

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

Parametry

format
String

Ciąg formatu złożonego.

args
Object[]

Tablica obiektów do sformatowania.

Zwraca

Odwołanie do tego wystąpienia z dołączonym format. Każdy element formatu w format jest zastępowany przez reprezentację ciągu odpowiadającego argumentu obiektu.

Wyjątki

format lub args jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości tablicy args.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie pokazano metodę AppendFormat.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektom na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym odpowiedni obiekt.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

args reprezentuje obiekty do sformatowania. Każdy element formatu w format jest zastępowany ciągiem reprezentującym odpowiedni obiekt w args. Jeśli element formatu zawiera formatString i odpowiedni obiekt w args implementuje interfejs IFormattable, args[index].ToString(formatString, provider) definiuje formatowanie. W przeciwnym razie args[index].ToString() definiuje formatowanie.

Jeśli ciąg przypisany do format to "Dziękujemy za darowiznę {0:#####} pach żywności dla naszej organizacji charytatywnej"., a arg0 jest liczbą całkowitą o wartości 10, wartość zwrotna będzie "Dziękuję za darowiznę 10 pach żywności dla naszej organizacji charytatywnej"."

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(String, Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez reprezentację ciągu pojedynczego argumentu.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia z dołączonym format. Każdy element formatu w format jest zastępowany przez reprezentację ciągu arg0.

Wyjątki

format jest null.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy niż lub równy 1.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

Przykłady

W poniższym przykładzie pokazano metodę AppendFormat.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego programu .NET Framework, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w bieżącym obiekcie StringBuilder.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych nazywanych elementami formatu. Indeks elementów formatu musi być 0, aby odpowiadać arg0, pojedynczy obiekt na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu reprezentacją ciągu arg0.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element.

Pierwiastek Opis
indeksu Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString Ciąg formatu standardowego lub niestandardowego obsługiwany przez parametr .

Nuta

Aby zapoznać się ze standardowymi i niestandardowymi ciągami formatu używanymi z wartościami daty i godziny, zobacz standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny. Aby uzyskać standardowe i niestandardowe ciągi formatu używane z wartościami liczbowymi, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego. Aby zapoznać się ze standardowymi ciągami formatu używanymi z wyliczeniami, zobacz Ciągi formatu wyliczenia.

arg0 reprezentuje obiekt do sformatowania. Każdy element formatu w format jest zastępowany reprezentacją ciągu arg0. Jeśli element formatu zawiera formatString i arg0 implementuje interfejs IFormattable, arg0.ToString(formatString, null) definiuje formatowanie. W przeciwnym razie arg0.ToString() definiuje formatowanie.

Jeśli ciąg przypisany do format to "Dziękujemy za darowiznę {0:#####} pach żywności dla naszej organizacji charytatywnej"., a arg0 jest liczbą całkowitą o wartości 10, wartość zwrotna będzie "Dziękuję za darowiznę 10 pach żywności dla naszej organizacji charytatywnej"."

Uwagi dotyczące wywoływania

W programie .NET Core i w programie .NET Framework 4.0 lub nowszym w przypadku utworzenia wystąpienia obiektu StringBuilder przez wywołanie konstruktora StringBuilder(Int32, Int32) zarówno długość, jak i pojemność wystąpienia StringBuilder mogą wzrosnąć poza wartość jej właściwości MaxCapacity. Może to wystąpić szczególnie w przypadku wywoływania metod Append(String) i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący odpowiadający mu argument w zakresie parametrów przy użyciu określonego dostawcy formatu.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

format
String

Ciąg formatu złożonego.

args
ReadOnlySpan<Object>

Zakres obiektów do formatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Długość rozwiniętego ciągu przekroczyłaby MaxCapacity.

format jest nieprawidłowa.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości zakresu args.

Dotyczy

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

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Parametry typu

TArg0

Typ pierwszego obiektu do sformatowania.

TArg1

Typ drugiego obiektu do sformatowania.

TArg2

Typ trzeciego obiektu do sformatowania.

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

arg0
TArg0

Pierwszy obiekt do sformatowania.

arg1
TArg1

Drugi obiekt do sformatowania.

arg2
TArg2

Trzeci obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Indeks elementu formatu jest większy lub równy liczbie podanych argumentów.

Dotyczy

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

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Parametry typu

TArg0

Typ pierwszego obiektu do sformatowania.

TArg1

Typ drugiego obiektu do sformatowania.

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

arg0
TArg0

Pierwszy obiekt do sformatowania.

arg1
TArg1

Drugi obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Indeks elementu formatu jest większy lub równy liczbie podanych argumentów.

Dotyczy

AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza ciąg zwracany przez przetwarzanie ciągu formatu złożonego, który zawiera zero lub więcej elementów formatu, do tego wystąpienia. Każdy element formatu jest zastępowany przez ciąg reprezentujący dowolny z argumentów przy użyciu określonego dostawcy formatu.

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

Parametry typu

TArg0

Typ pierwszego obiektu do sformatowania.

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

arg0
TArg0

Pierwszy obiekt do sformatowania.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

format jest null.

Indeks elementu formatu jest większy lub równy liczbie podanych argumentów.

Dotyczy