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

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Strings.vb

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

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

Weitere Informationen

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• Zeichenfolgenbearbeitung