Str, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Retourne la représentation String d'un nombre.

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

Paramètres

Number
Requis. Expression Object contenant toute expression numérique valide.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentNullException	5	Number n'est pas spécifié.
InvalidCastException	5	Number n'est pas un type numérique.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Lorsque des nombres sont convertis en chaînes, un espace à gauche est toujours réservé pour le signe de Number. Si Number est positif, la chaîne retournée contient un espace à gauche et le signe plus est implicite. Un nombre négatif inclura le signe moins (-) et pas d'espace à gauche.

Utilisez la fonction Format pour convertir les valeurs numériques que vous voulez mettre aux formats dates, heures ou monnaie ou dans d'autres formats définis par l'utilisateur. À la différence de la fonction Str, la fonction Format ne comprend pas d'espace à gauche pour le signe de Number.

Remarque :
La fonction Str ne reconnaît que le point (.) comme séparateur décimal valide. Si d'autres séparateurs décimaux sont utilisés (dans les applications internationales, par exemple), convertissez le nombre en chaîne à l'aide de la fonction CStr ou Format. Pour obtenir la représentation sous forme de chaîne d'un nombre dans une culture particulière, utilisez la méthode ToString(IFormatProvider) du nombre. Par exemple, utilisez ToString lors de la conversion d'une valeur de type Double en une chaîne.

La fonction Str ne reconnaît que le point (.) comme séparateur décimal valide. Si d'autres séparateurs décimaux sont utilisés (dans les applications internationales, par exemple), convertissez le nombre en chaîne à l'aide de la fonction CStr ou Format. Pour obtenir la représentation sous forme de chaîne d'un nombre dans une culture particulière, utilisez la méthode ToString(IFormatProvider) du nombre. Par exemple, utilisez ToString lors de la conversion d'une valeur de type Double en une chaîne.

Exemple

L'exemple suivant utilise la fonction Str pour retourner la représentation String d'un nombre. Lorsqu'un nombre positif est converti en chaîne, un espace à gauche est toujours réservé à son signe.

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