FormatPercent-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt einen Ausdruck als Prozentangabe (d. h. multipliziert mit 100) und einem abschließenden %-Zeichen zurück.
Function FormatPercent(
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 Einstellungen des Gebietsschemas verwendet werden.IncludeLeadingDigit
Optional. TriState-Konstante, die angibt, ob führende Nullen bei Dezimalzahlen angezeigt werden. Werte finden Sie im Abschnitt "Einstellungen".UseParensForNegativeNumbers
Optional. TriState-Konstante, die angibt, ob negative Werte in Klammern gesetzt werden. Werte finden Sie im Abschnitt "Einstellungen".GroupDigits
Optional. TriState-Konstante, die angibt, ob Zahlen mit dem in den Gebietsschemaeinstellungen angegebenen Trennzeichen gruppiert werden. 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.Default |
Die Ländereinstellungen des Computers. |
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
---|---|---|
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 von den Einstellungen im Gebietsschema 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 Verwendung der FormatPercent-Funktion.
Dim TestNumber As Single = 0.76
' Returns "76.00%".
Dim TestString As String = FormatPercent(TestNumber)
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)