閱讀英文

共用方式為

Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) 方法

  • 參考

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.Core.dll
組件:
Microsoft.VisualBasic.dll
來源:
Strings.vb
來源:
Strings.vb
來源:
Strings.vb

使用 [系統] 控制台中定義的貨幣符號，傳回格式化成貨幣值的運算式。

public static string FormatCurrency (object? Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);
public static string FormatCurrency (object Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);

參數

Expression
Object

必要。 要格式化的運算式。

NumDigitsAfterDecimal
Int32

選擇性。 數值，表示小數點右邊要顯示多少位。 預設值為 -1，表示要使用電腦的地區設定。

IncludeLeadingDigit
TriState

選擇性。 TriState 列舉，表示是否要顯示小數值前面的零。 如需值，請參閱＜備註＞。

UseParensForNegativeNumbers
TriState

選擇性。 TriState 列舉，表示是否要將負值放在括號內。 如需值，請參閱＜備註＞。

GroupDigits
TriState

選擇性。 TriState 列舉，表示是否使用電腦的地區設定中指定之群組分隔符號將數字分組。 如需值，請參閱＜備註＞。

傳回

String

使用 [系統] 控制台中定義的貨幣符號，格式化成貨幣值的運算式。

例外狀況

ArgumentException

小數點後的數字超過 99 個。

InvalidCastException

型別不是數字。

範例

下面範例說明如何使用 FormatCurrency 函式：

Dim testDebt As Double = -4456.43
Dim testString As String
' Returns "($4,456.43)".
testString = FormatCurrency(testDebt, , , TriState.True, TriState.True)

備註

省略一或多個選擇性自變數時，會改用計算機的相符地區設定值。

貨幣符號相對於貨幣值的位置取決於系統的區域設定。

注意

所有設定資訊都來自應用程式的地區設定。 根據預設，這會是控制面板中設定的地區設定。 不過，它可以使用 .NET Framework 以程序設計方式變更，但前置零是來自Number索引標籤。

IncludeLeadingDigit、 UseParensForNegativeNumbers和 GroupDigits 自變數採用下列 TriState 列舉值。

值 描述
TriState.True True
TriState.False False
TriState.UseDefault 計算機的地區設定

適用於

產品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另請參閱