FormatNumber-Funktion (Visual Basic)

  • Artikel

Aktualisiert: November 2007

Gibt einen als Zahl formatierten Ausdruck zurück.

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

Parameter

  • Expression
    Erforderlich. Zu formatierender Ausdruck.

  • NumDigitsAfterDecimal
    Optional. Numerischer Wert, der angibt, wie viele Stellen rechts vom Dezimaltrennzeichen angezeigt werden. Der Standardwert ist –1, d. h., dass die Ländereinstellungen des Computers verwendet werden.

  • IncludeLeadingDigit
    Optional. TriState-Konstante für die Anzeige von führenden Nullen bei Dezimalzahlen. Werte finden Sie im Abschnitt "Einstellungen".

  • UseParensForNegativeNumbers
    Optional. TriState-Konstante für die Verwendung von Klammern bei negativen Werten. Werte finden Sie im Abschnitt "Einstellungen".

  • GroupDigits
    Optional. TriState-Konstante für die Gruppierung von Zahlen mit den in den Gebietsschemaeinstellungen angegebenen Trennzeichen. Werte finden Sie im Abschnitt "Einstellungen".

Einstellungen

Die Argumente IncludeLeadingDigit, UseParensForNegativeNumbers und GroupDigits haben folgende Einstellungen.

Konstante

Beschreibung

TriState.True

True

TriState.False

False

TriState.UseDefault

Die Ländereinstellungen des Computers.

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

InvalidCastException

13

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

Wenn ein oder mehrere optionale Argumente ausgelassen werden, werden die Werte für ausgelassene Argumente den Gebietsschemaeinstellungen bereitgestellt.

Hinweis:

Alle Einstellungsinformationen werden vom Gebietsschema der Anwendung übernommen. Standardmäßig handelt es sich hierbei um das in der Systemsteuerung eingestellte Gebietsschema. Dies kann jedoch mit .NET Framework programmgesteuert geändert werden.

Beispiel

Dieses Beispiel zeigt die FormatNumber-Funktion.

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

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

Zeichenfolgenbearbeitung: Zusammenfassung

FormatCurrency-Funktion (Visual Basic)

FormatDateTime-Funktion (Visual Basic)

FormatPercent-Funktion (Visual Basic)

Tristate-Enumeration

InvalidCastException