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 常数,指示是否使用区域设置中指定的组分隔符对数字进行分组。请参见“设置”了解具体的值。

设置

IncludeLeadingDigit、UseParensForNegativeNumbers 和 GroupDigits 参数具有下列设置:

常数

说明

TriState.True

True

TriState.False

False

TriState.Default

计算机的区域设置

异常

异常类型

错误号

条件

InvalidCastException

13

类型不是数字。

如果正在升级使用无结构错误处理的 Visual Basic 6.0 应用程序,请参见“错误号”一列。(您可以根据 Number 属性(Err 对象)比较错误号。)然而,如果可能,应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

备注

当省略一个或多个可选参数时,省略参数的值由区域设置提供。

说明:

所有设置信息均来自应用程序的区域设置。默认情况下,这些信息是在控制面板中设置的区域设置。但是,可以通过使用 .NET Framework 以编程方式对其进行更改。

示例

本示例演示 FormatPercent 函数的用法。

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

要求

命名空间:Microsoft.VisualBasic

**模块:**Strings

**程序集:**Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)

请参见

参考

字符串操作摘要

FormatCurrency 函数 (Visual Basic)

FormatDateTime 函数 (Visual Basic)

FormatNumber 函数 (Visual Basic)

TriState 枚举

InvalidCastException