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

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

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

static member FormatCurrency : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string

Public Function FormatCurrency (Expression As Object, Optional NumDigitsAfterDecimal As Integer = -1, Optional IncludeLeadingDigit As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional UseParensForNegativeNumbers As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional GroupDigits As TriState = Microsoft.VisualBasic.TriState.UseDefault) As String

參數

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	計算機的地區設定

另請參閱

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• 字串操作