自訂數值格式字串

您所建立且由一或多個自訂數值格式規範所組成的自訂數值格式字串會定義如何格式化數值資料，自訂數值格式字串相當於定義為不是標準數值格式字串的任何字串。

下表說明自訂數值的格式規範。如需每種格式規範所產生之輸出的範例，請參閱自訂數值格式字串輸出範例。如需詳細資訊，請參閱表格之後的注意事項。

注意

無限浮點數和 NaN

請注意，不管格式字串為何，如果 Single 或 Double 浮點型別為正無限大、負無限大或不是數字 (NaN)，則格式化後的字串分別會是由目前適用之 NumberFormatInfo 物件所指定的 PositiveInfinitySymbol、NegativeInfinitySymbol 或 NaNSymbol 屬性。

控制台設定值

[控制台] 中 [地區及語言選項] 項目的設定會影響格式化作業所產生的結果字串。這些設定是用來初始化與目前執行緒文化特性相關聯的 NumberFormatInfo 物件，而且目前的執行緒文化特性會提供用來管理格式的值。使用不同設定的電腦將會產生不同的結果字串。

四捨五入和定點格式字串

請注意，如果是定點格式字串 (即不含科學標記法格式字元的格式字串)，則數值會四捨五入成與小數點右邊之數字替代符號一樣多的小數位數。如果格式字串不包含小數點，數值四捨五入至最接近的整數。如果數值有比小數點左邊的數字預留位置還要多的位數，額外位數會緊接第一個數字預留位置之前複製到輸出字串。

區段分隔符號和格式化的條件

各種格式可以根據值是否為正數、負數或零來套用於字串。若要產生這個行為，自訂格式字串可以包含多達三個以分號分隔的區段，下表將說明這些區段。

區段分隔符號會在最終值已格式化時，忽略任何事先存在而與數值相關的格式。例如，負數值在使用區段分隔符號時永遠不以負號來顯示。如果您想要最終的格式化值具有負號，您應該明確包含負號做為自訂 格式規範的一部分。

下列程式碼片段將說明如何使用區段分隔符號來產生格式化的字串。

Dim MyPos As Double = 19.95
Dim MyNeg As Double = -19.95
Dim MyZero As Double = 0

' In the U.S. English culture, MyString has the value: $19.95.
Dim MyString As String = MyPos.ToString("$#,##0.00;($#,##0.00);Zero")

' In the U.S. English culture, MyString has the value: ($19.95).
' The minus sign is omitted by default.
MyString = MyNeg.ToString("$#,##0.00;($#,##0.00);Zero")

' In the U.S. English culture, MyString has the value: Zero.
MyString = MyZero.ToString("$#,##0.00;($#,##0.00);Zero")

double MyPos = 19.95, MyNeg = -19.95, MyZero = 0.0;

// In the U.S. English culture, MyString has the value: $19.95.
string MyString = MyPos.ToString("$#,##0.00;($#,##0.00);Zero");

// In the U.S. English culture, MyString has the value: ($19.95).
// The minus sign is omitted by default.
MyString = MyNeg.ToString("$#,##0.00;($#,##0.00);Zero");

// In the U.S. English culture, MyString has the value: Zero.
MyString = MyZero.ToString("$#,##0.00;($#,##0.00);Zero");

兩個自訂格式範例

下列程式碼片段將示範自訂數值的格式化。在這兩個範例中，自訂格式字串內的數字替代符號 (#) 會顯示數值資料，並將所有其他的字元複製到輸出中。

Dim myDouble As Double = 1234567890
Dim myString As String = myDouble.ToString( "(###) ### - ####" )
' The value of myString is "(123) 456 – 7890".

Dim MyInt As Integer = 42
MyString = MyInt.ToString( "My Number = #" )
' In the U.S. English culture, MyString has the value: 
' "My Number = 42".

Double myDouble = 1234567890;
String myString = myDouble.ToString( "(###) ### - ####" );
// The value of myString is "(123) 456 – 7890".

int  MyInt = 42;
MyString = MyInt.ToString( "My Number = #" );
// In the U.S. English culture, MyString has the value: 
// "My Number = 42".

請參閱

參考

NumberFormatInfo

概念

數值格式字串
自訂數值格式字串輸出範例
標準數值格式字串

其他資源

格式化型別