Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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);
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
Výraz formátovaný jako hodnota měny pomocí symbolu měny definovaného v ovládacích panelech systému.
Výjimky
Počet číslic za desetinnou čárkou je větší než 99.
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
, UseParensForNegativeNumbers
a 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 |