Conversion.Val, méthode (Object)

Retourne les nombres contenus dans une chaîne sous la forme d'une valeur numérique d'un type approprié.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Val ( _
    Expression As Object _
) As Double
'Utilisation
Dim Expression As Object
Dim returnValue As Double

returnValue = Conversion.Val(Expression)

public static double Val (
    Object Expression
)

public:
static double Val (
    Object^ Expression
)

public static double Val (
    Object Expression
)

public static function Val (
    Expression : Object
) : double

Paramètres

• Expression
  Obligatoire. Toute expression String, Object variable ou valeur Char valide. Si Expression est de type Object, sa valeur doit être convertible en String ou une erreur ArgumentException se produit.

Valeur de retour

Retourne les nombres contenus dans une chaîne sous la forme d'une valeur numérique d'un type approprié.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic « Val, fonction ».

La fonction Val arrête de lire la chaîne au premier caractère qu'elle ne peut pas reconnaître comme faisant partie d'un nombre. Les symboles et caractères souvent considérés comme des parties de valeurs numériques, telles que les signes dollar et les virgules, ne sont pas reconnus. En revanche, la fonction reconnaît les préfixes &O (pour octal) et &H (pour hexadécimal). Les espaces, onglets et caractères de saut de ligne sont supprimés de l'argument.

L'appel suivant retourne la valeur 1615198.

                        Val(" 1615 198th Street N.E.") 

L'appel suivant retourne la valeur décimale -1.

                        Val("&HFFFF") 

Notes

La fonction Val reconnaît uniquement le point (.) comme séparateur décimal valide. Lorsque des séparateurs décimaux différents sont utilisés, comme dans les applications internationales, utilisez CDbl ou CInt à la place pour convertir une chaîne en nombre. Pour convertir la représentation sous forme de chaîne d'un nombre dans une culture spécifique en valeur numérique, utilisez la méthode Parse(String, IFormatProvider) du type numérique Utilisez par exemple Double.Parse lors de la conversion d'une chaîne en Double.

Exemple

L'exemple suivant utilise la fonction Val pour retourner les nombres contenus dans chaque chaîne. Val arrête la conversion au premier caractère ne pouvant pas être interprété comme un chiffre, un modificateur numérique, une ponctuation numérique ou un espace blanc.

Dim valResult As Double
' The following line of code sets valResult to 2457.
valResult = Val("2457")
' The following line of code sets valResult to 2457.
valResult = Val(" 2 45 7")
' The following line of code sets valResult to 24.
valResult = Val("24 and 57")

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Conversion, classe
Membres Conversion
Microsoft.VisualBasic, espace de noms
OverflowException
InvalidCastException
ArgumentException

Autres ressources

Val, fonction
Str, fonction
Fonctions de conversion de types de données