FormatPercent 函式 (Visual Basic)

更新：2007 年 11 月

傳回格式化為百分比 (也就是乘以 100) 並在後面加上 % 字元的運算式。

Function FormatPercent(
   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 常數，指出是否要使用地區設定中指定的群組分隔符號 (Delimiter) 來群組數字。請參閱值的「設定」。

設定

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

常數	描述
TriState.True	True
TriState.False	False
TriState.Default	電腦的地區設定

例外狀況

例外狀況類型	錯誤代碼	條件
InvalidCastException	13	不是數字型別。

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

備註

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

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

範例

這個範例將說明 FormatPercent 函式的用法。

Dim TestNumber As Single = 0.76
' Returns "76.00%".
Dim TestString As String = FormatPercent(TestNumber)

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

模組：Strings

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

請參閱

參考

字串操作摘要

FormatCurrency 函式 (Visual Basic)

FormatDateTime 函式 (Visual Basic)

FormatNumber 函式 (Visual Basic)

Tristate 列舉型別

InvalidCastException