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

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

Strings.vb

Vrátí výraz formátovaný jako hodnota měny pomocí symbolu měny definovaného v ovládacích panelech systému.

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

Povinná hodnota. Výraz, který se má formátovat.

NumDigitsAfterDecimal

Int32

Nepovinný parametr. Číselná hodnota označující, kolik míst se zobrazí napravo od desetinné čárky. Výchozí hodnota je -1, což označuje, že se používají místní nastavení počítače.

IncludeLeadingDigit

TriState

Nepovinný parametr. TriState výčet, který označuje, zda se pro desetinné hodnoty zobrazuje úvodní nula. Hodnoty najdete v části Poznámky.

UseParensForNegativeNumbers

TriState

Nepovinný parametr. TriState výčet, který označuje, zda se mají do závorek umístit záporné hodnoty. Hodnoty najdete v části Poznámky.

GroupDigits

TriState

Nepovinný parametr. TriState výčet označující, zda jsou čísla seskupena pomocí oddělovače skupin zadaného v místním nastavení počítače. Hodnoty najdete v části Poznámky.

Návraty

String

Výraz formátovaný jako hodnota měny pomocí symbolu měny definovaného v ovládacích panelech systému.

Výjimky

ArgumentException

Počet číslic za desetinnou čárkou je větší než 99.

InvalidCastException

Typ není číselný.

Příklady

Následující příklad znázorňuje použití FormatCurrency funkce.

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

Poznámky

Pokud je jeden nebo více volitelných argumentů vynecháno, místo toho se použijí odpovídající hodnoty místního nastavení počítače.

Pozice symbolu měny vzhledem k hodnotě měny je určena místním nastavením systému.

Poznámka

Všechny informace o nastavení pocházejí z národního prostředí aplikace. Ve výchozím nastavení to bude národní prostředí nastavené v ovládacích panelech. Může se však programově změnit pomocí rozhraní .NET Framework s výjimkou počáteční nuly, která pochází z Number karty.

Argumenty IncludeLeadingDigit, UseParensForNegativeNumbersa GroupDigits přebírají následující hodnoty výčtu TriState.

Hodnota	Popis
TriState.True	Ano
TriState.False	Ne
TriState.UseDefault	Místní nastavení počítače

Viz také

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• Zacházení s řetězci