StringBuilder.AppendFormat 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目會由對應之物件引數的字串表示所取代。
多載
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。 |
AppendFormat(String, Object, Object, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為三個引數中任一個的字串表示。 |
AppendFormat(IFormatProvider, String, Object, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為兩個引數中的其中一個字串表示。 |
AppendFormat(String, Object, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為兩個引數中任一個的字串表示。 |
AppendFormat(IFormatProvider, String, Object, Object, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為三個引數中的其中一個字串表示。 |
AppendFormat(IFormatProvider, CompositeFormat, Object[]) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。 |
AppendFormat(String, ReadOnlySpan<Object>) | |
AppendFormat(IFormatProvider, String, Object[]) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目會由參數陣列 (此參數陣列使用所指定的格式提供者) 中對應之物件引數的字串表示所取代。 |
AppendFormat(IFormatProvider, String, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為單一引數的字串表示。 |
AppendFormat(String, Object[]) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目會由參數陣列中對應之引數的字串表示所取代。 |
AppendFormat(String, Object) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為單一引數的字串表示。 |
AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>) | |
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。 |
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。 |
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0) |
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。 |
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。
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
參數
- provider
- IFormatProvider
物件,提供特定文化特性格式資訊。
- format
- CompositeFormat
- args
- ReadOnlySpan<Object>
要格式化的物件範圍。
傳回
完成附加作業之後,這個執行個體的參考。
例外狀況
format
為 null
。
格式專案的索引大於或等於提供的自變數數目。
適用於
AppendFormat(String, Object, Object, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為三個引數中任一個的字串表示。
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
要格式化的第三個物件。
傳回
附加 format
的執行個體參考。 format
中的每一個格式項目會由對應之物件引數的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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
arg2
,這個方法的參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件的字串表示。
格式項目的語法如下所示:
{index[,length][:formatString]}
在方括號中的元素是選擇性的元素。 下表說明每個元素。
元素 | 描述 |
---|---|
index | 要格式化之物件之參數清單中的以零起始的位置。 如果 索引 所指定的物件是 null ,格式專案會取代為 String.Empty。 如果 索引 位置中沒有參數, FormatException 則會擲回 。 |
,長度 | 參數位符串表示中的字元數下限。 如果為正數,則參數靠右對齊;如果為負數,則為靠左對齊。 |
:formatString | 參數支持的標準或自定義格式字串。 |
注意
如需搭配日期和時間值使用的標準和自訂格式字串,請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。 如需搭配數值使用的標準和自定義格式字串,請參閱 標準數值格式字串 和 自定義數值格式字串。 如需搭配列舉使用的標準格式字串,請參閱 列舉格式字串。
arg0
、 arg1
和 arg2
表示要格式化的物件。 中的每個format
格式項目都會以、 arg1
或 arg2
的字串表示arg0
取代,視格式專案的索引而定。 如果格式專案包含 formatString
和中args
對應的 物件會IFormattable實作 介面,則arg
x .ToString(formatString, null)
會定義格式,其中 x 是自變數的索引。 否則, arg
x.ToString()
會定義格式設定。
如果指派 format
給的字串是「感謝您將 {0:####} 的食物貢獻給我們的可食物組織」,而且 arg0
是值為 10 的整數,則傳回值會是「感謝您將 10 個食物的贊助給我們的食物組織」。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(IFormatProvider, String, Object, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為兩個引數中的其中一個字串表示。
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
要格式化的第二個物件。
傳回
完成附加作業之後,這個執行個體的參考。 在附加作業之後,此執行個體會包含此作業之前已存在的所有資料,並後置有 format
的複本,其中的任何格式規格都會由對應物件引數的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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物件中。
參數 format
包含零或多個與零或多個索引佔位元混合的文字,稱為格式項目,對應至這個方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件的字串表示。
格式項目的語法如下所示:
{index[,length][:formatString]}
在方括號中的元素是選擇性的元素。 下表說明每個元素。
元素 | 描述 |
---|---|
index | 要格式化之物件參數清單中的以零起始的位置。 如果 索引 指定的物件是 null ,則格式專案會取代為 String.Empty。 如果 索引 位置中沒有參數, FormatException 則會擲回 。 |
,長度 | 參數位符串表示中的字元數下限。 如果為正數,則參數靠右對齊;如果為負數,則會靠左對齊。 |
:formatString | 參數支持的標準或自定義格式字串。 |
注意
如需與日期和時間值搭配使用的標準和自定義格式字串,請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。 如需搭配數值使用的標準和自定義格式字串,請參閱 標準數值格式字串 和 自定義數值格式字串。 如需搭配列舉使用的標準格式字串,請參閱 列舉格式字串。
參數provider
會指定可為 IFormatProvider 和 arg1
提供格式資訊的arg0
實作。 provider
可以是下列任何項目:
物件 CultureInfo ,提供特定文化特性的格式資訊。
物件 NumberFormatInfo ,其提供特定文化特性的格式資訊
arg0
,如果為數值,則為 或arg1
。物件 DateTimeFormatInfo ,提供特定文化特性的格式資訊
arg0
,如果arg1
它們是日期和時間值,則為 。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) 方法以附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 作法:定義和使用自訂數值格式提供者
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(String, Object, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為兩個引數中任一個的字串表示。
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
要格式化的第二個物件。
傳回
附加 format
的執行個體參考。 format
中的每一個格式項目會由對應之物件引數的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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 .ToString(formatString, provider)
會定義格式,其中 x 是自變數的索引。 否則, arg
x.ToString()
會定義格式設定。
如果指派 format
給的字串是「感謝您將 {0:####} 的食物貢獻給我們的可食物組織」,而且 arg0
是值為 10 的整數,則傳回值會是「感謝您將 10 個食物的贊助給我們的食物組織」。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(IFormatProvider, String, Object, Object, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為三個引數中的其中一個字串表示。
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
要格式化的第三個物件。
傳回
完成附加作業之後,這個執行個體的參考。 在附加作業之後,此執行個體會包含此作業之前已存在的所有資料,並後置有 format
的複本,其中的任何格式規格都會由對應物件引數的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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 和 arg1
提供格式資訊的arg0
實作。 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()
方法會定義格式設定。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 作法:定義和使用自訂數值格式提供者
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(IFormatProvider, CompositeFormat, Object[])
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會使用指定的格式提供者,由任何自變數的字串表示取代。
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
- args
- Object[]
要格式化的物件陣列。
傳回
完成附加作業之後,這個執行個體的參考。
例外狀況
format
或 args
為 null
。
格式專案的索引大於或等於提供的自變數數目。
適用於
AppendFormat(String, ReadOnlySpan<Object>)
public:
System::Text::StringBuilder ^ AppendFormat(System::String ^ format, ReadOnlySpan<System::Object ^> args);
public System.Text.StringBuilder AppendFormat (string format, scoped ReadOnlySpan<object?> args);
member this.AppendFormat : string * ReadOnlySpan<obj> -> System.Text.StringBuilder
Public Function AppendFormat (format As String, args As ReadOnlySpan(Of Object)) As StringBuilder
參數
- format
- String
- args
- ReadOnlySpan<Object>
傳回
適用於
AppendFormat(IFormatProvider, String, Object[])
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目會由參數陣列 (此參數陣列使用所指定的格式提供者) 中對應之物件引數的字串表示所取代。
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[]
要格式化的物件陣列。
傳回
完成附加作業之後,這個執行個體的參考。 在附加作業之後,此執行個體會包含此作業之前已存在的所有資料,並後置有 format
的複本,其中的任何格式規格都會由對應物件引數的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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) 方法來附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 作法:定義和使用自訂數值格式提供者
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(IFormatProvider, String, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 使用指定的格式提供者,將每個格式項目取代為單一引數的字串表示。
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
要格式化的物件。
傳回
完成附加作業之後,這個執行個體的參考。 在附加作業之後,這個執行個體會包含作業前已經存在的所有資料,並後置有 format
的複本,其中的任何格式規格都會由 arg0
的字串表示所取代。
例外狀況
format
為 null
。
展開後的字串長度會超過 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()
定義格式設定。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 作法:定義和使用自訂數值格式提供者
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(String, Object[])
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目會由參數陣列中對應之引數的字串表示所取代。
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[]
要格式化的物件陣列。
傳回
附加 format
的執行個體參考。 format
中的每一個格式項目會由對應之物件引數的字串表示所取代。
例外狀況
format
或 args
為 null
。
展開後的字串長度會超過 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
包含零或多個與零或多個索引佔位元混合的文字,稱為格式項目,對應至這個方法參數清單中的物件。 格式化程式會將每個格式專案取代為對應物件的字串表示。
格式項目的語法如下所示:
{index[,length][:formatString]}
在方括號中的元素是選擇性的元素。 下表說明每個元素。
元素 | 描述 |
---|---|
index | 要格式化之物件參數清單中的以零起始的位置。 如果 索引 指定的物件是 null ,則格式專案會取代為 String.Empty。 如果 索引 位置中沒有參數, FormatException 則會擲回 。 |
,長度 | 參數位符串表示中的字元數下限。 如果為正數,則參數靠右對齊;如果為負數,則會靠左對齊。 |
:formatString | 參數支持的標準或自定義格式字串。 |
注意
如需與日期和時間值搭配使用的標準和自定義格式字串,請參閱 標準日期和時間格式字串 和 自定義日期和時間格式字串。 如需搭配數值使用的標準和自定義格式字串,請參閱 標準數值格式字串 和 自定義數值格式字串。 如需搭配列舉使用的標準格式字串,請參閱 列舉格式字串。
args
表示要格式化的物件。 中的每個 format
格式項目都會取代為 中 args
對應物件的字串表示。 如果格式專案包含 formatString
和 中的 args
對應物件會 IFormattable 實作 介面,則 args[index].ToString(formatString, provider)
定義格式設定。 否則, args[index].ToString()
定義格式設定。
如果指派 format
給的字串是「感謝您將 {0:####} 的食物貢獻給我們的可食物組織」,而且 arg0
是值為 10 的整數,則傳回值會是「感謝您將 10 個食物的贊助給我們的食物組織」。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(String, Object)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每一個格式項目都會取代為單一引數的字串表示。
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
要格式化的物件。
傳回
附加 format
的執行個體參考。 format
中的每一個格式項目都會取代為 arg0
的字串表示。
例外狀況
format
為 null
。
展開後的字串長度會超過 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 個食物的感謝給可食物的組織」。
給呼叫者的注意事項
在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String) 和 AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。
另請參閱
- 在 .NET 中將類型格式化
- 複合格式
- 標準數值格式字串
- Custom Numeric Format Strings
- 標準日期和時間格式字串
- 自訂日期和時間格式字串
- 標準 TimeSpan 格式字串
- 自訂 TimeSpan 格式字串
- Enumeration Format Strings
適用於
AppendFormat(IFormatProvider, String, ReadOnlySpan<Object>)
public:
System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, ReadOnlySpan<System::Object ^> args);
public System.Text.StringBuilder AppendFormat (IFormatProvider? provider, string format, scoped ReadOnlySpan<object?> args);
member this.AppendFormat : IFormatProvider * string * ReadOnlySpan<obj> -> System.Text.StringBuilder
Public Function AppendFormat (provider As IFormatProvider, format As String, args As ReadOnlySpan(Of Object)) As StringBuilder
參數
- provider
- IFormatProvider
- format
- String
- args
- ReadOnlySpan<Object>
傳回
適用於
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。
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
- arg0
- TArg0
要格式化的第一個物件。
- arg1
- TArg1
要格式化的第二個物件。
- arg2
- TArg2
要格式化的第三個物件。
傳回
完成附加作業之後,這個執行個體的參考。
例外狀況
format
為 null
。
格式專案的索引大於或等於提供的自變數數目。
適用於
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。
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
- arg0
- TArg0
要格式化的第一個物件。
- arg1
- TArg1
要格式化的第二個物件。
傳回
完成附加作業之後,這個執行個體的參考。
例外狀況
format
為 null
。
格式專案的索引大於或等於提供的自變數數目。
適用於
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)
將處理複合格式字串所傳回的字串 (其中包含零或更多的格式項目) 附加至這個執行個體。 每個格式項目都會由任何使用指定格式提供者之自變數的字串表示來取代。
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
- arg0
- TArg0
要格式化的第一個物件。
傳回
完成附加作業之後,這個執行個體的參考。
例外狀況
format
為 null
。
格式專案的索引大於或等於提供的自變數數目。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應