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

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Restituisce un'espressione nel formato valore di valuta utilizzando il simbolo di valuta impostato nel Pannello di controllo del sistema.

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

Parametri

Expression

Object

Obbligatorio. Espressione da formattare.

NumDigitsAfterDecimal

Int32

facoltativo. Valore numerico che indica quante cifre vengono visualizzate a destra del segno decimale. Il valore predefinito è -1, che indica che vengono usate le impostazioni internazionali del computer.

IncludeLeadingDigit

TriState

facoltativo. Enumerazione TriState che indica se visualizzare o meno uno zero iniziale per i valori frazionari. Per informazioni sui valori, vedere la sezione "Osservazioni".

UseParensForNegativeNumbers

TriState

facoltativo. Enumerazione TriState che indica se racchiudere i valori negativi tra parentesi. Per informazioni sui valori, vedere la sezione "Osservazioni".

GroupDigits

TriState

facoltativo. Enumerazione TriState che indica se raggruppare i numeri utilizzando il delimitatore di gruppo specificato nelle impostazioni internazionali del computer. Per informazioni sui valori, vedere la sezione "Osservazioni".

Restituisce

String

Espressione formattata come valore di valuta usando il simbolo di valuta definito nel pannello di controllo del sistema.

Eccezioni

ArgumentException

Il numero di cifre dopo il separatore decimale è maggiore di 99.

InvalidCastException

Tipo non numerico.

Esempio

L'esempio seguente illustra l'uso della funzione FormatCurrency.

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

Commenti

Quando uno o più argomenti facoltativi vengono omessi, vengono invece usati i valori delle impostazioni internazionali corrispondenti del computer.

La posizione del simbolo di valuta rispetto al valore di valuta è determinata dalle impostazioni internazionali del sistema.

Nota

Tutte le informazioni sulle impostazioni provengono dalle impostazioni locali dell'applicazione. Per impostazione predefinita, le impostazioni locali verranno impostate nel pannello di controllo. Tuttavia, può essere modificato a livello di codice usando .NET Framework, ad eccezione dello zero iniziale, che proviene dalla Number scheda.

Gli IncludeLeadingDigitargomenti , UseParensForNegativeNumberse GroupDigits accettano i valori di enumerazione TriState seguenti.

Valore	Descrizione
TriState.True	True
TriState.False	Falso
TriState.UseDefault	Impostazioni internazionali del computer

Vedi anche

• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• Format(Object, String)
• ArgumentException
• InvalidCastException
• Manipolazione delle stringhe