Funzione FormatNumber (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un'espressione in formato di numero.

Function FormatNumber(
   ByVal Expression As Object,
   Optional ByVal NumDigitsAfterDecimal As Integer = -1,
   Optional ByVal IncludeLeadingDigit As TriState = TriState.UseDefault,
   Optional ByVal UseParensForNegativeNumbers As TriState = TriState.UseDefault,
   Optional ByVal GroupDigits As TriState = TriState.UseDefault
) As String

Parametri

Expression
Obbligatorio. Espressione alla quale verrà applicato il formato.
NumDigitsAfterDecimal
Facoltativo. Valore numerico che indica il numero di cifre decimali da visualizzare a destra del separatore. Il valore predefinito, -1, indica che sono in uso le impostazioni internazionali del sistema.
IncludeLeadingDigit
Facoltativo. Costante TriState che indica se visualizzare o meno uno zero iniziale per i valori frazionari. I possibili valori sono indicati nella sezione "Impostazioni".
UseParensForNegativeNumbers
Facoltativo. Costante TriState che indica se racchiudere o meno tra parentesi i valori negativi. I possibili valori sono indicati nella sezione "Impostazioni".
GroupDigits
Facoltativo. Costante TriState che indica se raggruppare o meno i numeri utilizzando il carattere di delimitazione di gruppo specificato nelle impostazioni internazionali. I possibili valori sono indicati nella sezione "Impostazioni".

Impostazioni

Di seguito sono riportate le impostazioni degli argomenti IncludeLeadingDigit, UseParensForNegativeNumbers e GroupDigits.

Costante	Descrizione
TriState.True	True
TriState.False	False
TriState.UseDefault	Le impostazioni internazionali del sistema.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
InvalidCastException	13	Il tipo non è numerico.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

I valori degli argomenti facoltativi eventualmente omessi vengono sostituiti con quelli delle impostazioni internazionali.

Nota:
Tutte le informazioni sulle impostazioni dipendono dalle impostazioni internazionali dell'applicazione, stabilite mediante la scelta nel Pannello di controllo. Tali informazioni possono tuttavia essere modificate a livello di codice utilizzando .NET Framework.

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo della funzione FormatNumber.

Dim TestNumber As Integer = 45600
' Returns "45,600.00".
Dim TestString As String = FormatNumber(TestNumber, 2, , , TriState.True)

Requisiti

Spazio dei nomi:Microsoft.VisualBasic

**Modulo:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Riepilogo della gestione delle stringhe

Funzione FormatCurrency (Visual Basic)

Funzione FormatDateTime (Visual Basic)

Funzione FormatPercent (Visual Basic)

Enumerazione TriState

InvalidCastException

Condividi tramite