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

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Strings.vb

Zwraca wyrażenie sformatowane jako wartość waluty przy użyciu symbolu waluty zdefiniowanego w panelu sterowania systemu.

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

Parametry

Expression

Object

Wymagane. Wyrażenie do sformatowania.

NumDigitsAfterDecimal

Int32

Opcjonalny. Wartość liczbowa wskazująca, ile miejsc jest wyświetlanych po prawej stronie przecinka dziesiętnego. Wartość domyślna to -1, co oznacza, że są używane ustawienia regionalne komputera.

IncludeLeadingDigit

TriState

Opcjonalny. TriState wyliczenie wskazujące, czy dla wartości ułamkowych jest wyświetlane zero wiodące. Zobacz "Uwagi" dla wartości.

UseParensForNegativeNumbers

TriState

Opcjonalny. TriState wyliczenie wskazujące, czy umieścić wartości ujemne w nawiasach. Zobacz "Uwagi" dla wartości.

GroupDigits

TriState

Opcjonalny. TriState wyliczenie wskazujące, czy liczby są grupowane przy użyciu ogranicznika grupy określonego w ustawieniach regionalnych komputera. Zobacz "Uwagi" dla wartości.

Zwraca

String

Wyrażenie sformatowane jako wartość waluty przy użyciu symbolu waluty zdefiniowanego w panelu sterowania systemu.

Wyjątki

ArgumentException

Liczba cyfr po przecinku dziesiętnego jest większa niż 99.

InvalidCastException

Typ nie jest numeryczny.

Przykłady

Poniższy przykład ilustruje użycie FormatCurrency funkcji.

Dim testDebt As Double = -4456.43
Dim testString As String
' Returns "($4,456.43)".
testString = FormatCurrency(testDebt, , , TriState.True, TriState.True)

Uwagi

Jeśli pominięto co najmniej jeden argument opcjonalny, zamiast tego są używane zgodne wartości ustawień regionalnych komputera.

Pozycja symbolu waluty względem wartości waluty jest określana przez ustawienia regionalne systemu.

Uwaga

Wszystkie informacje o ustawieniach pochodzą z ustawień regionalnych aplikacji. Domyślnie będzie to ustawienia regionalne ustawione w panelu sterowania. Można go jednak zmienić programowo przy użyciu .NET Framework, z wyjątkiem zera wiodącegoNumber, który pochodzi z karty.

Argumenty IncludeLeadingDigit, UseParensForNegativeNumbersi GroupDigits przyjmują następujące wartości wyliczenia TriState.

Wartość	Opis
TriState.True	Prawda
TriState.False	Fałsz
TriState.UseDefault	Ustawienia regionalne komputera

Zobacz też

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• Manipulowanie ciągami