Str 函式

發行項
08/21/2008

更新：2007 年 11 月

傳回數字的 String 代表。

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

參數

Number
必要項。含有任何有效數值運算式的 Object。

例外狀況

例外狀況類型	錯誤代碼	條件
ArgumentNullException	5	未指定 Number。
InvalidCastException	5	Number 不是數字型別 (Numeric Type)。

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

備註

將數字轉換成字串 (String) 時，一律會為 Number 的正負號保留句首空格。如果 Number 是正數值，則所傳回的字串會包含句首空格，並加上隱含的正號。負數將會包括減號 (-)，且沒有前置空格。

使用 Format 函式，以轉換要格式化成日期 (Date)、時間或貨幣 (Currency) 或其他使用者定義格式的數值。Format 函式與 Str 函式不同，它不會為 Number 的正負號加入前置空格。

注意事項：
Str 函式只會將句號 (.) 辨認為有效的十進位分隔符號。如果使用不同的小數點分隔符號 (例如，國際性應用程式)，請使用 CStr 或 Format 函式以便將數字轉換成字串。若要在特定文化特性 (Culture) 中取得數字的字串表示，請使用數字的 ToString(IFormatProvider) 方法。例如，將型別 Double 的值轉換成 String 時，請使用 ToString。

Str 函式只會將句號 (.) 辨認為有效的十進位分隔符號。如果使用不同的小數點分隔符號 (例如，國際性應用程式)，請使用 CStr 或 Format 函式以便將數字轉換成字串。若要在特定文化特性 (Culture) 中取得數字的字串表示，請使用數字的 ToString(IFormatProvider) 方法。例如，將型別 Double 的值轉換成 String 時，請使用 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)