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

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Strings.vb

Quelle:: Strings.vb

Quelle:: Strings.vb

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 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

String

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

Ausnahmen

ArgumentException

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

InvalidCastException

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:

Freigeben über