Condividi tramite


Funzione FormatNumber (Visual Basic)

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