Freigeben über


Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Methode

Definition

Gibt einen Ausdruck als Währungsbetrag zurück, der mit dem in der Systemsteuerung festgelegten Währungssymbol formatiert ist.

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);
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 -> string
Public 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 String

Parameter

Expression
Object

Erforderlich. Der zu formatierende Ausdruck.

NumDigitsAfterDecimal
Int32

Dies ist optional. Numerischer Wert, der angibt, wie viele Stellen hinter dem Dezimaltrennzeichen angezeigt werden. Der Standardwert ist –1 und gibt an, dass die regionalen Einstellungen des Computers verwendet werden.

IncludeLeadingDigit
TriState

Dies ist optional. TriState-Enumeration, die angibt, ob bei Bruchwerten eine führende Null angezeigt wird. Weitere Informationen finden Sie in den Hinweisen zu Werten.

UseParensForNegativeNumbers
TriState

Dies ist optional. TriState-Enumeration, die angibt, ob negative Werte in Klammern gesetzt werden. Weitere Informationen finden Sie in den Hinweisen zu Werten.

GroupDigits
TriState

Dies ist optional. TriState-Enumeration, die angibt, ob Zahlen mithilfe des Gruppentrennzeichens gruppiert werden, das in den regionalen Einstellungen des Computers definiert ist. Weitere Informationen finden Sie in den Hinweisen zu Werten.

Gibt zurück

Ein mit dem in der Systemsteuerung festgelegten Währungssymbol als Währungsbetrag formatierter Ausdruck.

Ausnahmen

Anzahl der Stellen nach dem Dezimalzeichen ist größer als 99.

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 ein oder mehrere optionale Argumente weggelassen werden, werden stattdessen die übereinstimmenden Werte für regionale Einstellungen des Computers verwendet.

Die Position des Währungssymbols relativ zum Währungswert wird durch die regionalen Einstellungen des Systems bestimmt.

Hinweis

Alle Einstellungsinformationen stammen aus dem Gebietsschema der Anwendung. Standardmäßig ist dies das in der Systemsteuerung festgelegte Gebietsschema. Es kann jedoch programmgesteuert mithilfe des .NET Framework geändert werden, mit Ausnahme der führenden Null, die von der Number Registerkarte stammt.

Die IncludeLeadingDigitArgumente , UseParensForNegativeNumbersund GroupDigits verwenden die folgenden TriState-Enumerationswerte.

Wert BESCHREIBUNG
TriState.True True
TriState.False False
TriState.UseDefault Die regionalen Einstellungen des Computers

Gilt für:

Weitere Informationen