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

Required. Výraz, který se má formátovat.

NumDigitsAfterDecimal

Int32

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

IncludeLeadingDigit

TriState

Optional. TriState výčet, který označuje, zda je pro desetinné hodnoty zobrazena úvodní nula. Hodnoty najdete v části Poznámky.

UseParensForNegativeNumbers

TriState

Optional. TriState výčet označující, zda se mají do závorek umístit záporné hodnoty nebo ne. Hodnoty najdete v části Poznámky.

GroupDigits

TriState

Optional. TriState Výčet, který označuje, zda jsou čísla seskupena pomocí oddělovače skupiny určené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 jeden nebo více nepovinných argumentů vynecháte, použijí se místo toho 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.

Note

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

Argumenty IncludeLeadingDigit, UseParensForNegativeNumbersa GroupDigits argumenty mají následující tristate výčtové hodnoty.

Hodnota	Description
TriState.True	Pravdivé
TriState.False	Nepravda
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
• Manipulace s řetězci