StringBuilder.AppendFormat 方法

參考

定義

命名空間:: System.Text

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目會由對應之物件引數的字串表示所取代。

多載

AppendFormat(String, Object, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目都會取代為兩個引數中任一個的字串表示。
AppendFormat(IFormatProvider, String, Object, Object, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。使用指定的格式提供者，將每個格式項目取代為三個引數中的其中一個字串表示。
AppendFormat(String, Object, Object, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目都會取代為三個引數中任一個的字串表示。
AppendFormat(IFormatProvider, String, Object, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。使用指定的格式提供者，將每個格式項目取代為兩個引數中的其中一個字串表示。
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每個格式專案都會由任何使用指定格式提供者之引數的字串表示來取代。
AppendFormat(String, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目都會取代為單一引數的字串表示。
AppendFormat(IFormatProvider, String, Object[])	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目會由參數陣列 (此參數陣列使用所指定的格式提供者) 中對應之物件引數的字串表示所取代。
AppendFormat(IFormatProvider, String, Object)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。使用指定的格式提供者，將每個格式項目取代為單一引數的字串表示。
AppendFormat(String, Object[])	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每一個格式項目會由參數陣列中對應之引數的字串表示所取代。
AppendFormat(IFormatProvider, CompositeFormat, Object[])	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每個格式專案都會由任何使用指定格式提供者之引數的字串表示來取代。
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每個格式專案都會由任何使用指定格式提供者之引數的字串表示來取代。
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每個格式專案都會由任何使用指定格式提供者之引數的字串表示來取代。
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。每個格式專案都會由任何使用指定格式提供者之引數的字串表示來取代。

AppendFormat(String, Object, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

format: String

複合格式字串。

arg0: Object

要格式化的第一個物件。

arg1: Object

要格式化的第二個物件。

傳回

StringBuilder

附加 format 的執行個體參考。 format 中的每一個格式項目會由對應之物件引數的字串表示所取代。

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 2。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例示範 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

備註

這個方法會使用.NET Framework的複合格式設定功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前的 StringBuilder 物件中。

參數 format 包含零或多個文字執行，與零個或多個索引預留位置混合，稱為格式專案，對應至 arg0 和 arg1 ，這個方法的參數清單中的兩個物件。格式化程式會將每個格式專案取代為對應物件的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件之參數清單中的以零起始的位置。如果索引所指定的物件是 `null` ，格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則為靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

如需搭配日期和時間值使用的標準和自訂格式字串，請參閱標準日期和時間格式字串和自訂日期和時間格式字串。如需搭配數值使用的標準和自訂格式字串，請參閱標準數值格式字串和自訂數值格式字串。如需搭配列舉使用的標準格式字串，請參閱列舉格式字串。

arg0 和 arg1 表示要格式化的物件。中的每個 format 格式專案都會取代為或 arg1 的 arg0 字串表示。如果格式專案包含 formatString 且對應的物件實作 IFormattable 介面，則arg x 會定義格式設定，其中x.ToString(formatString, provider) 是引數的索引。否則， argx.ToString() 會定義格式設定。

如果指派給 format 的字串是「感謝您將 {0：####} 食物的感謝提供給我們的可食物組織」，而且 arg0 是值為 10 的整數，則傳回值會是「感謝您將 10 個食物的感謝給可食物的組織」。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中，當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時，實例的 StringBuilder 長度和容量都可以成長超過其 MaxCapacity 屬性的值。當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時，就會發生此情況。

另請參閱

適用於

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

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: String

複合格式字串。

arg0: Object

要格式化的第一個物件。

arg1: Object

要格式化的第二個物件。

arg2: Object

要格式化的第三個物件。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。在附加作業之後，此執行個體會包含此作業之前已存在的所有資料，並後置有 format 的複本，其中的任何格式規格都會由對應物件引數的字串表示所取代。

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 3 (三)。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例會 AppendFormat(IFormatProvider, String, Object, Object, Object) 使用方法來說明具有整數值的布林 And 運算結果。請注意，格式字串包含六個格式專案，但方法在其引數清單中只有三個專案，因為每個專案都以兩種不同的方式格式化。

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)

備註

這個方法會使用.NET Framework的複合格式設定功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前的 StringBuilder 物件中。

參數 format 是由零或多個文字執行所組成，這些文字與零個或多個索引預留位置混合，稱為格式專案，對應至此方法參數清單中的物件。格式化程式會將每個格式專案取代為對應物件的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件之參數清單中的以零起始的位置。如果索引所指定的物件是 `null` ，格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則為靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

參數 provider 會指定實 IFormatProvider 作 arg0 ，可為和 arg1 提供格式資訊。 provider 可以是下列任何項目：

物件 CultureInfo ，提供特定文化特性的格式資訊。
物件 NumberFormatInfo ，提供特定文化特性的格式資訊 arg0 ，如果為數值，則為或 arg1 。
物件 DateTimeFormatInfo ，提供、 arg1 或 arg2 的特定文化特性格式資訊 arg0 ，如果它們是日期和時間值，則為。
自訂 IFormatProvider 實作，提供、 arg1 和 arg2 的格式 arg0 資訊。一般而言，這類實作也會實作 ICustomFormatter 介面。

provider如果參數為 null ，則會從目前的文化特性取得格式提供者資訊。

arg0、 arg1 和 arg2 表示要格式化的物件。中的每個 format 格式專案都會取代為具有對應索引之物件的字串表示。如果格式專案包含 formatString 且對應的引數實 IFormattable 作介面，則引數的 ToString(formatString, provider) 方法會定義格式設定。否則，引數的 ToString() 方法會定義格式設定。

給呼叫者的注意事項

另請參閱

適用於

AppendFormat(String, Object, Object, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

format: String

複合格式字串。

arg0: Object

要格式化的第一個物件。

arg1: Object

要格式化的第二個物件。

arg2: Object

要格式化的第三個物件。

傳回

StringBuilder

附加 format 的執行個體參考。 format 中的每一個格式項目會由對應之物件引數的字串表示所取代。

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 3。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例示範 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

備註

這個方法會使用.NET Framework的複合格式設定功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前的 StringBuilder 物件中。

參數 format 包含零或多個文字執行，與零個或多個索引預留位置混合，稱為格式專案，這些格式專案會對應至 arg0arg2 ，這個方法的參數清單中的物件。格式化程式會將每個格式專案取代為對應物件的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件之參數清單中的以零起始的位置。如果索引所指定的物件是 `null` ，格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則為靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

arg0、 arg1 和 arg2 表示要格式化的物件。中的每個 format 格式專案都會取代為、 arg1 或 arg2 的 arg0 字串表示，視格式專案的索引而定。如果格式專案包含 formatString 和中的 argsIFormattable 對應物件實作介面，則arg x 會定義格式，其中x.ToString(formatString, null) 是引數的索引。否則， argx.ToString() 會定義格式設定。

給呼叫者的注意事項

另請參閱

適用於

AppendFormat(IFormatProvider, String, Object, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: String

複合格式字串。

arg0: Object

要格式化的第一個物件。

arg1: Object

要格式化的第二個物件。

傳回

StringBuilder

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 2 (二)。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例會 AppendFormat(IFormatProvider, String, Object, Object) 使用方法來顯示儲存在泛型 Dictionary<TKey,TValue> 物件中的時間和溫度資料。請注意，格式字串有三個格式專案，不過只有物件可以格式化。這是因為清單中的第一個物件 (日期和時間值) 由兩個格式專案使用：第一個格式專案會顯示時間，而第二個則會顯示日期。

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

備註

這個方法會使用.NET Framework的複合格式設定功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前的 StringBuilder 物件中。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件之參數清單中的以零起始的位置。如果索引所指定的物件是 `null` ，格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則為靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

參數 provider 會指定實 IFormatProvider 作 arg0 ，可為和 arg1 提供格式資訊。 provider 可以是下列任何項目：

物件 CultureInfo ，提供特定文化特性的格式資訊。
物件 NumberFormatInfo ，提供特定文化特性的格式資訊 arg0 ，如果為數值，則為或 arg1 。
物件 DateTimeFormatInfo ，針對或 arg1 提供特定文化特性的格式資訊 arg0 ，如果它們是日期和時間值，則為。
IFormatProvider自訂實作，提供和 arg1 的格式 arg0 資訊。一般而言，這類實作也會實作 ICustomFormatter 介面。

provider如果參數為 null ，則會從目前的文化特性取得格式提供者資訊。

arg0 和 arg1 表示要格式化的物件。中的每個 format 格式專案都會取代為具有對應索引之物件的字串表示。如果格式專案包含 formatString 且對應的引數實 IFormattable 作介面，則引數的 ToString(formatString, provider) 方法會定義格式設定。否則，引數的 ToString() 方法會定義格式設定。

給呼叫者的注意事項

IIn .NET Core 和 .NET Framework 4.0 和更新版本中，當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時，實例的 StringBuilder 長度和容量都可以成長超過其 MaxCapacity 屬性的值。當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時，就會發生此情況。

另請參閱

適用於

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Source:: StringBuilder.cs

Source:: 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);

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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: CompositeFormat

CompositeFormat。

args: ReadOnlySpan<Object>

要格式化的物件範圍。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

format 為 null。

FormatException

格式專案的索引大於或等於提供的引數數目。

適用於

AppendFormat(String, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

format: String

複合格式字串。

arg0: Object

要格式化的物件。

傳回

StringBuilder

附加 format 的執行個體參考。 format 中的每一個格式項目都會取代為 arg0 的字串表示。

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 1。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例示範 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

備註

這個方法會使用.NET Framework的複合格式功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前 StringBuilder 物件中。

參數 format 包含零或多個文字執行，與零或多個索引預留位置混合，稱為格式專案。格式專案的索引必須是 0，才能對應至 arg0 這個方法參數清單中的單一物件。格式設定程式會將每個格式專案取代為的 arg0 字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件參數清單中的以零起始的位置。如果索引指定的物件是 `null` ，則格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則會靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

如需與日期和時間值搭配使用的標準和自訂格式字串，請參閱標準日期和時間格式字串和自訂日期和時間格式字串。如需搭配數值使用的標準和自訂格式字串，請參閱標準數值格式字串和自訂數值格式字串。如需搭配列舉使用的標準格式字串，請參閱列舉格式字串。

arg0 表示要格式化的物件。中的每個 format 格式專案都會取代為的 arg0 字串表示。如果格式專案包含 formatString 並實作 IFormattable 介面，則 arg0.ToString(formatString, null)arg0 定義格式設定。否則， arg0.ToString() 定義格式設定。

如果指派 format 給的字串是「感謝您將 {0：####} 的食物貢獻給我們的可食物組織」，而且 arg0 是值為 10 的整數，則傳回值會是「感謝您將 10 個食物的贊助給我們的食物組織」。

給呼叫者的注意事項

另請參閱

適用於

AppendFormat(IFormatProvider, String, Object[])

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: String

複合格式字串。

args: Object[]

要格式化的物件陣列。

傳回

StringBuilder

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零)，或大於或等於 args 陣列的長度。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例示範 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

下列範例會定義名為的 CustomerFormatter 自訂 IFormatProvider 實作，此實作會將 10 位數的客戶編碼格式化為第四位數和第七位數之後的連字號。它會傳遞至 StringBuilder.AppendFormat(IFormatProvider, String, Object[]) 方法，以建立包含格式化客戶號碼和客戶名稱的字串。

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

備註

這個方法會使用.NET Framework的複合格式功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前 StringBuilder 物件中。

參數 format 包含零或多個與零或多個索引預留位置混合的文字，稱為格式專案，對應至這個方法參數清單中的物件。格式化程式會將每個格式專案取代為對應物件的字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件參數清單中的以零起始的位置。如果索引指定的物件是 `null` ，則格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則會靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

參數 provider 會指定實 IFormatProvider 作，可為中的 args 物件提供格式化資訊。 provider 可以是下列任何項目：

物件 CultureInfo ，提供特定文化特性的格式資訊。
NumberFormatInfo物件，提供中 args 數值的文化特性特定格式資訊。
DateTimeFormatInfo物件，提供中 args 日期和時間值的文化特性特定格式資訊。
自訂 IFormatProvider 實作，提供中 args 一或多個物件的格式化資訊。一般而言，這類實作也會實作 ICustomFormatter 介面。下一節的第二個 StringBuilder.AppendFormat(IFormatProvider, String, Object[]) 範例說明使用自訂 IFormatProvider 實作的方法呼叫。

provider如果參數為 null ，則會從目前文化特性取得格式提供者資訊。

args 表示要格式化的物件。中的每個 format 格式專案都會取代為中 args 對應物件的字串表示。如果格式專案包含 formatString 和中的 args 對應物件會 IFormattable 實作介面，則 args[index].ToString(formatString, provider) 定義格式設定。否則， args[index].ToString() 定義格式設定。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中，當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時，實例的 StringBuilder 長度和容量都可以成長超過其 MaxCapacity 屬性的值。特別是當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法以附加小型字串時，就會發生此情況。

另請參閱

適用於

AppendFormat(IFormatProvider, String, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: String

複合格式字串。

arg0: Object

要格式化的物件。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。在附加作業之後，這個執行個體會包含作業前已經存在的所有資料，並後置有 format 的複本，其中的任何格式規格都會由 arg0 的字串表示所取代。

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零) 或大於等於 1。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列包含對方法的兩個 AppendFormat(IFormatProvider, String, Object) 呼叫。兩者都使用 English-United 英國 (en-GB) 文化特性的格式慣例。第一個會在結果字串中插入值貨幣的 Decimal 字串表示。第二個會在結果字串的兩個位置插入值，第一個 DateTime 位置只包含短日期字串，而第二個是短時間字串。

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

備註

這個方法會使用.NET Framework的複合格式功能，將的值 arg0 轉換成其文字標記法，並將該標記法內嵌在目前的 StringBuilder 物件中。

參數 format 包含零或多個文字執行，與零或多個索引預留位置混合，稱為格式專案。每個格式專案的索引必須是零 (0) ，因為這個方法包含具有單一引數的引數清單。格式設定程式會將每個格式專案取代為的 arg0 字串表示。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件參數清單中的以零起始的位置。如果索引指定的物件是 `null` ，則格式專案會取代為 String.Empty 。在此情況下，由於 AppendFormat(IFormatProvider, String, Object) 方法在引數清單中具有單一引數，因此索引的值一律為 0。如果不是， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則會靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

參數 provider 會指定實 IFormatProvider 作，可為中的 args 物件提供格式化資訊。 provider 可以是下列任何項目：

物件 CultureInfo ，提供特定文化特性的格式資訊。
物件 NumberFormatInfo ，如果其為數值，則提供特定文化特性的格式資訊 arg0 。
物件 DateTimeFormatInfo ，如果它是日期和時間值，則提供特定文化特性的格式資訊 arg0 。
IFormatProvider自訂實作，提供的格式 arg0 資訊。一般而言，這類實作也會實作 ICustomFormatter 介面。

provider如果參數為 null ，則會從目前文化特性取得格式資訊。

arg0 表示要格式化的物件。中的每個 format 格式專案都會取代為的 arg0 字串表示。如果格式專案包含 formatString 並實作 IFormattable 介面，則 arg0.ToString(formatString, provider)arg0 定義格式設定。否則， arg0.ToString() 定義格式設定。

給呼叫者的注意事項

另請參閱

適用於

AppendFormat(String, Object[])

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: 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

參數

format: String

複合格式字串。

args: Object[]

要格式化的物件陣列。

傳回

StringBuilder

附加 format 的執行個體參考。 format 中的每一個格式項目會由對應之物件引數的字串表示所取代。

例外狀況

ArgumentNullException

format 或 args 為 null。

FormatException

format 無效。

-或-

格式項目的索引小於 0 (零)，或大於或等於 args 陣列的長度。

ArgumentOutOfRangeException

展開後的字串長度會超過 MaxCapacity。

範例

下列範例示範 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

備註

這個方法會使用.NET Framework的複合格式功能，將物件的值轉換成其文字標記法，並將該標記法內嵌在目前 StringBuilder 物件中。

格式專案的語法如下所示：

{index[，length][：formatString]}

在方括號中的元素是選擇性的元素。下表說明每個元素。

元素	描述
index	要格式化之物件參數清單中的以零起始的位置。如果索引指定的物件是 `null` ，則格式專案會取代為 String.Empty 。如果索引位置中沒有參數， FormatException 則會擲回。
，長度	參數字串表示中的字元數下限。如果為正數，則參數靠右對齊;如果為負數，則會靠左對齊。
：formatString	參數支援的標準或自訂格式字串。

注意

args 表示要格式化的物件。中的每個 format 格式專案都會取代為中 args 對應物件的字串表示。如果格式專案包含 formatString 和中的 args 對應物件會實 IFormattable 作介面，則 args[index].ToString(formatString, provider) 定義格式設定。否則， args[index].ToString() 請定義格式設定。

給呼叫者的注意事項

另請參閱

適用於

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Source:: StringBuilder.cs

Source:: 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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: CompositeFormat

CompositeFormat。

args: Object[]

要格式化的物件陣列。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

format 或 args 為 null。

FormatException

格式專案的索引大於或等於提供的引數數目。

適用於

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

Source:: StringBuilder.cs

Source:: 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

類型參數

TArg0

要格式化的第一個物件型別。

TArg1

要格式化的第二個物件型別。

TArg2

要格式化的第三個物件類型。

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: CompositeFormat

CompositeFormat。

arg0: TArg0

要格式化的第一個物件。

arg1: TArg1

要格式化的第二個物件。

arg2: TArg2

要格式化的第三個物件。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

format 為 null。

FormatException

格式專案的索引大於或等於提供的引數數目。

適用於

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

Source:: StringBuilder.cs

Source:: 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

類型參數

TArg0

要格式化的第一個物件型別。

TArg1

要格式化的第二個物件型別。

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: CompositeFormat

CompositeFormat。

arg0: TArg0

要格式化的第一個物件。

arg1: TArg1

要格式化的第二個物件。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

format 為 null。

FormatException

格式專案的索引大於或等於提供的引數數目。

適用於

AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Source:: StringBuilder.cs

Source:: 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

類型參數

TArg0

要格式化的第一個物件型別。

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

format: CompositeFormat

CompositeFormat。

arg0: TArg0

要格式化的第一個物件。

傳回

StringBuilder

完成附加作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

format 為 null。

FormatException

格式專案的索引大於或等於提供的引數數目。

適用於