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 参数有以下设置。

异常

如果正在升级使用非结构化错误处理方式的 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