Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt einen als Währungswert formatierten Ausdruck unter Verwendung des in der Systemsteuerung des Systems definierten Währungssymbols zurück.
public static string FormatCurrency(object Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);static member FormatCurrency : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> stringPublic Function FormatCurrency (Expression As Object, Optional NumDigitsAfterDecimal As Integer = -1, Optional IncludeLeadingDigit As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional UseParensForNegativeNumbers As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional GroupDigits As TriState = Microsoft.VisualBasic.TriState.UseDefault) As StringParameter
- Expression
- Object
Required. Der zu formatierende Ausdruck.
- NumDigitsAfterDecimal
- Int32
Dies ist optional. Numerischer Wert, der angibt, wie viele Stellen rechts vom Dezimaltrennzeichen angezeigt werden. Der Standardwert ist -1, was angibt, dass die regionalen Einstellungen des Computers verwendet werden.
- IncludeLeadingDigit
- TriState
Dies ist optional. TriState Aufzählung, die angibt, ob für Bruchwerte eine führende Null angezeigt wird. Werte finden Sie unter "Hinweise".
- UseParensForNegativeNumbers
- TriState
Dies ist optional. TriState aufzählung, die angibt, ob negative Werte in Klammern platziert werden sollen. Werte finden Sie unter "Hinweise".
- GroupDigits
- TriState
Dies ist optional. TriState Aufzählung, die angibt, ob Zahlen mithilfe des gruppentrennzeichens gruppiert werden, das in den regionalen Einstellungen des Computers angegeben ist. Werte finden Sie unter "Hinweise".
Gibt zurück
Ein Ausdruck, der als Währungswert formatiert ist, wobei das währungssymbol verwendet wird, das in der Systemsteuerung definiert ist.
Ausnahmen
Die Anzahl der Ziffern nach dem Dezimalkomma ist größer als 99.
Der Typ ist nicht numerisch.
Beispiele
Das folgende Beispiel veranschaulicht die Verwendung der FormatCurrency Funktion.
Dim testDebt As Double = -4456.43
Dim testString As String
' Returns "($4,456.43)".
testString = FormatCurrency(testDebt, , , TriState.True, TriState.True)
Hinweise
Wenn mindestens ein optionales Argument ausgelassen wird, werden stattdessen die übereinstimmenden Werte für regionale Einstellungen des Computers verwendet.
Die Position des Währungssymbols relativ zum Währungswert wird durch die Landes-/Regionaleinstellungen des Systems bestimmt.
Note
Alle Einstellungsinformationen stammen aus dem Gebietsschema der Anwendung. Standardmäßig ist dies das Gebietsschema, das in der Systemsteuerung festgelegt ist. Es kann jedoch programmgesteuert mithilfe des .NET Frameworks geändert werden, mit Ausnahme der führenden Null, die von der Registerkarte Number stammt.
Die IncludeLeadingDigitArgumente und UseParensForNegativeNumbersGroupDigits Die Argumente verwenden die folgenden TriState-Enumerationswerte.
| Value | Description |
|---|---|
TriState.True |
Richtig |
TriState.False |
Falsch |
TriState.UseDefault |
Regionale Einstellungen des Computers |