通过

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
    可选。三态常数，指示是否显示小数值的前导零。请参见“设置”了解具体的值。

  • UseParensForNegativeNumbers
    可选。三态常数，指示是否在括号内放置负值。请参见“设置”了解具体的值。

  • GroupDigits
    可选。三态常数，指示是否使用区域设置中指定的组分隔符对数字进行分组。请参见“设置”了解具体的值。

设置

IncludeLeadingDigit、UseParensForNegativeNumbers 和 GroupDigits 参数有以下设置。

常数

说明

TriState.True

True

TriState.False

False

TriState.UseDefault

计算机的区域设置

异常

异常类型

错误号

条件

InvalidCastException

13

类型不是数字。

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

备注

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

说明：

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

示例

本例说明 FormatNumber 函数。

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

要求

命名空间：Microsoft.VisualBasic

**模块：**Strings

**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）

请参见

参考

字符串操作摘要

FormatCurrency 函数 (Visual Basic)

FormatDateTime 函数 (Visual Basic)

FormatPercent 函数 (Visual Basic)

TriState 枚举

InvalidCastException