Str 函数

Visual Studio 2005

返回数字的 String 表示形式。

Public Shared Function Str(ByVal Number As Object) As String

参数

Number: 必选。包含任何有效的数值表达式的 Object。

异常

异常类型	错误号	条件
ArgumentNullException	5	未指定 Number。
InvalidCastException	5	Number 不是 numeric 类型。

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

备注

当数字转换为字符串时，始终为 Number 的符号保留一个前导空格。如果 Number 为正，则返回的字符串包含前导空格，并暗含加号。负数将包括减号 (-)，且没有前导空格。

使用 Format 函数转换您需要格式化为日期、时间或货币或者其他用户定义格式的数值。与 Str 函数不同，Format 函数不包含用于 Number 的符号的前导空格。

注意
Str 函数只将句点 (.) 识别为有效的小数点分隔符。如果使用其他小数点分隔符（例如在国际应用程序中），请使用 CStr 或 Format 函数将数字转换为字符串。若要获得特定区域中数字的字符串表示形式，请使用数字的 `ToString(IFormatProvider)` 方法。例如，将 Double 类型的值转换为字符串时，使用 ToString。

注意

Str 函数只将句点 (.) 识别为有效的小数点分隔符。如果使用其他小数点分隔符（例如在国际应用程序中），请使用 CStr 或 Format 函数将数字转换为字符串。若要获得特定区域中数字的字符串表示形式，请使用数字的 ToString(IFormatProvider) 方法。例如，将 Double 类型的值转换为字符串时，使用 ToString。

示例

本示例使用 Str 函数返回数字的 String 表示形式。当正数转换为字符串时，始终为其符号保留一个前导空格。

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)

要求

命名空间： Microsoft.VisualBasic

模块： Conversion

程序集： Visual Basic Runtime Library（在 Microsoft.VisualBasic.dll 中）