Str-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt eine String-Darstellung einer Zahl zurück.

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

Parameter

Number
Erforderlich. Ein Object, das alle gültigen numerischen Ausdrücke enthält.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentNullException	5	Number ist nicht angegeben.
InvalidCastException	5	Number ist kein numerischer Typ.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Beim Konvertieren von Zahlen in Zeichenfolgen wird stets ein führendes Leerzeichen für das Vorzeichen von Number reserviert. Wenn Number positiv ist, enthält die zurückgegebene Zeichenfolge ein führendes Leerzeichen (anstelle des Pluszeichens). Bei einer negativen Zahl wird anstelle des führenden Leerzeichens ein Minuszeichen (-) eingefügt.

Verwenden Sie die Format-Funktion, um numerische Werte in ein Datum, eine Zeitangabe, eine Währung oder ein anderes benutzerdefiniertes Format zu konvertieren. Im Gegensatz zur Str-Funktion fügt die Format-Funktion kein führendes Leerzeichen für das Vorzeichen von Number ein.

Hinweis:
Die Str-Funktion erkennt nur den Punkt (.) als gültiges Dezimaltrennzeichen. Wenn ein anderes Dezimaltrennzeichen benötigt wird (z. B. weil in einem anderen Land oder einer anderen Region andere Zeichensetzungskonventionen gelten), verwenden Sie stattdessen die CStr-Funktion oder die Format-Funktion, um eine Zahl in eine Zeichenfolge zu konvertieren. Um die Zeichenfolgendarstellung einer Zahl in einem bestimmten Format abzurufen, verwenden Sie die ToString(IFormatProvider)-Methode der Zahl. Verwenden Sie beispielsweise ToString, wenn Sie einen Wert des Typs Double in eine Zeichenfolge konvertieren.

Die Str-Funktion erkennt nur den Punkt (.) als gültiges Dezimaltrennzeichen. Wenn ein anderes Dezimaltrennzeichen benötigt wird (z. B. weil in einem anderen Land oder einer anderen Region andere Zeichensetzungskonventionen gelten), verwenden Sie stattdessen die CStr-Funktion oder die Format-Funktion, um eine Zahl in eine Zeichenfolge zu konvertieren. Um die Zeichenfolgendarstellung einer Zahl in einem bestimmten Format abzurufen, verwenden Sie die ToString(IFormatProvider)-Methode der Zahl. Verwenden Sie beispielsweise ToString, wenn Sie einen Wert des Typs Double in eine Zeichenfolge konvertieren.

Beispiel

In diesem Beispiel wird die Str-Funktion verwendet, um eine Zahl als String zurückzugeben. Wird eine positive Zahl in eine Zeichenfolge konvertiert, so wird stets ein führendes Leerzeichen anstelle eines Vorzeichens reserviert.

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