Funzione Str

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce una rappresentazione String di un numero.

Public Shared Function Str(ByVal Number As Object) As String

Parametri

Number
Obbligatorio. Un Object contenente qualsiasi espressione numerica valida.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentNullException	5	Number non è specificato.
InvalidCastException	5	Number non è un tipo 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

Quando si convertono numeri in stringhe, viene sempre riservato uno spazio iniziale al segno di Number. Se Number è positivo, la stringa restituita conterrà uno spazio iniziale in cui è sottinteso il segno più. In caso di numero negativo, nello spazio iniziale verrà inserito il segno meno (-).

Utilizzare la funzione Format per convertire valori numerici ai quali si desidera applicare i formati di data, ora, valuta o altri formati definiti dall'utente. A differenza della funzione Str, la funzione Format non prevede uno spazio iniziale per il segno di Number.

Nota:
La funzione Str riconosce solo il punto (.) come separatore decimale valido. Se per la conversione di un numero in stringa sono richiesti separatori decimali diversi, ad esempio nelle applicazioni internazionali, utilizzare le funzioni CStr o Format. Per ottenere la rappresentazione di stringa di un numero in una determinata lingua, utilizzare il metodo ToString(IFormatProvider) del numero. Ad esempio, utilizzare ToString per la conversione di un valore di tipo Double in una stringa.

La funzione Str riconosce solo il punto (.) come separatore decimale valido. Se per la conversione di un numero in stringa sono richiesti separatori decimali diversi, ad esempio nelle applicazioni internazionali, utilizzare le funzioni CStr o Format. Per ottenere la rappresentazione di stringa di un numero in una determinata lingua, utilizzare il metodo ToString(IFormatProvider) del numero. Ad esempio, utilizzare ToString per la conversione di un valore di tipo Double in una stringa.

Esempio

Nell'esempio riportato di seguito la funzione Str viene utilizzata per restituire una rappresentazione String di un numero. Quando si converte un numero positivo in stringa, viene sempre riservato uno spazio iniziale per il segno.

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)