Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Metódus

Definíció

Névtér:

Microsoft.VisualBasic

Szerelvény:

Microsoft.VisualBasic.Core.dll

Forrás:

Strings.vb

Egy pénznemértékként formázott kifejezést ad vissza a rendszer vezérlőpultján meghatározott pénznemjel alapján.

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

Paraméterek

Expression

Object

Kötelező. Formázandó kifejezés.

NumDigitsAfterDecimal

Int32

Optional. Numerikus érték, amely azt jelzi, hogy hány hely jelenik meg a tizedesvessző jobb oldalán. Az alapértelmezett érték -1, ami azt jelzi, hogy a számítógép területi beállításait használja a rendszer.

IncludeLeadingDigit

TriState

Optional. TriState enumerálás, amely azt jelzi, hogy egy kezdő nulla jelenik-e meg a tört értékeknél. Az értékekért lásd a "Megjegyzések" című témakört.

UseParensForNegativeNumbers

TriState

Optional. TriState enumerálás, amely azt jelzi, hogy a negatív értékeket zárójelek közé kell-e helyezni. Az értékekért lásd a "Megjegyzések" című témakört.

GroupDigits

TriState

Optional. TriState enumerálás, amely azt jelzi, hogy a számok a számítógép területi beállításaiban megadott csoportelválasztóval vannak-e csoportosítva. Az értékekért lásd a "Megjegyzések" című témakört.

Válaszok

String

Pénznemértékként formázott kifejezés a rendszer vezérlőpultjában definiált pénznemszimbólummal.

Kivételek

ArgumentException

A tizedesvessző utáni számjegyek száma nagyobb, mint 99.

InvalidCastException

A típus nem numerikus.

Példák

Az alábbi példa a függvény használatát FormatCurrency mutatja be.

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

Megjegyzések

Ha egy vagy több választható argumentumot kihagy, a rendszer ehelyett a számítógép területi beállításoknak megfelelő értékeit használja.

A pénznem jelének pénznemértékhez viszonyított helyzetét a rendszer területi beállításai határozzák meg.

Note

Minden beállítási információ az alkalmazás területi beállításaiból származik. Alapértelmezés szerint ez lesz a vezérlőpult területi beállítása. Ez azonban programozott módon módosítható a .NET-keretrendszer használatával, kivéve az első nullát, amely a Number lapról származik.

A IncludeLeadingDigit, UseParensForNegativeNumbersés GroupDigits az argumentumok a következő TriState-számbavételi értékeket veszik figyelembe.

Érték	Leírás
TriState.True	True
TriState.False	Téves
TriState.UseDefault	A számítógép területi beállításai

Lásd még

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• Sztringek kezelése