FormatNumber 函式 (Visual Basic)

更新:2007 年 11 月

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

Function FormatNumber(
   ByVal Expression As Object,
   Optional ByVal NumDigitsAfterDecimal As Integer = -1,
   Optional ByVal IncludeLeadingDigit As TriState = TriState.UseDefault,
   Optional ByVal UseParensForNegativeNumbers As TriState = TriState.UseDefault,
   Optional ByVal GroupDigits As TriState = TriState.UseDefault
) As String

參數

  • Expression
    必要項。要格式化的運算式。

  • NumDigitsAfterDecimal
    選擇項。指示小數點後面要顯示多少位數的數值。預設值為 –1,表示要使用電腦的地區設定。

  • IncludeLeadingDigit
    選擇項。TriState 常數,指出是否要在分數值前面顯示零。請參閱值的「設定」。

  • UseParensForNegativeNumbers
    選擇項。TriState 常數,指出是否要將負值置於括號內。請參閱值的「設定」。

  • GroupDigits
    選擇項。TriState 常數,指出是否要使用地區設定 (Locale) 中指定的群組分隔符號來群組數字。請參閱值的「設定」。

設定

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

常數

描述

TriState.True

True

TriState.False

False

TriState.UseDefault

電腦的地區設定

例外狀況

例外狀況類型

錯誤代碼

條件

InvalidCastException

13

不是數字型別。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級,請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是,請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

省略一或多個選擇性引數時,省略引數的值將由地區設定提供。

注意事項:

所有設定資訊都來自於應用程式的地區設定 (Locale)。依預設,這是在 [控制台] 中設定的地區設定。不過,您也可使用 .NET Framework 來利用程式變更。

範例

這個範例將說明如何使用 FormatNumber 函式。

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

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

模組:Strings

組件 (Assembly):Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

字串操作摘要

FormatCurrency 函式 (Visual Basic)

FormatDateTime 函式 (Visual Basic)

FormatPercent 函式 (Visual Basic)

Tristate 列舉型別

InvalidCastException