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

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

Strings.vb

傳回格式化成數字的運算式。

public static string FormatNumber (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 FormatNumber : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string

Public Function FormatNumber (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 常數，表示是否要顯示小數值的前置 0 字元。 如需有關值的資訊，請參閱＜設定＞。

UseParensForNegativeNumbers

TriState

選擇性。 TriState 常數，表示是否要將負值放在括號內。 如需有關值的資訊，請參閱＜設定＞。

GroupDigits

TriState

選擇性。 TriState 常數，指出是否使用地區設定中指定的群組分隔符號將數字分組。 如需有關值的資訊，請參閱＜設定＞。

傳回

String

格式化成數字的運算式。

例外狀況

InvalidCastException

型別不是數字。

範例

此範例示範 函 FormatNumber 式。

Dim testNumber As Integer = 45600
' Returns "45,600.00".
Dim testString As String = FormatNumber(testNumber, 2, , , TriState.True)

備註

當省略一或多個選擇性自變數時，省略自變數的值會由地區設定提供。

注意

所有設定資訊都來自應用程式的地區設定。 根據預設，這會是控制面板中設定的地區設定。 不過，它可能會透過程式設計方式變更，方法是使用 .NET Framework。

IncludeLeadingDigit、 UseParensForNegativeNumbers和 GroupDigits 自變數具有下列設定。

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

另請參閱

• FormatCurrency(Object, Int32, TriState, TriState, TriState)
• FormatDateTime(DateTime, DateFormat)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• InvalidCastException
• 字串操作摘要