Partager via

Conversion.Str, méthode

  • Article

Retourne une représentation String d'un nombre.

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

Syntaxe

'Déclaration
Public Shared Function Str ( _
    Number As Object _
) As String
'Utilisation
Dim Number As Object
Dim returnValue As String

returnValue = Conversion.Str(Number)

public static string Str (
    Object Number
)

public:
static String^ Str (
    Object^ Number
)

public static String Str (
    Object Number
)

public static function Str (
    Number : Object
) : String

Paramètres

  • Number
    Obligatoire. Object contenant toute expression numérique valide.

Valeur de retour

Retourne une représentation String d'un nombre.

Notes

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

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 aucun espace à gauche.

Utilisez la fonction Format pour convertir les valeurs numériques vous souhaitez mettre dans un format de date, d'heure ou de devise ou tout autre format défini par l'utilisateur. Contrairement à la fonction Str, la fonction Format n'inclut pas d'espace à gauche pour le signe de Number.

Notes

La fonction Str reconnaît uniquement le point (.) comme séparateur décimal valide. Si des séparateurs décimaux différents sont utilisés (par exemple, dans les applications internationales), utilisez les fonctions CStr ou Format pour convertir un nombre en chaîne. Pour obtenir la représentation sous forme de chaîne d'un nombre dans une culture spécifique, utilisez la méthode ToString(IFormatProvider) du nombre. Par exemple, utilisez ToString lors de la conversion d'une valeur de type Double en chaîne.

Exemple

Cet exemple utilise la fonction Str pour retourner une représentation String d'un nombre. Lorsqu'un nombre positif est converti en chaîne, un espace à gauche est toujours réservé pour 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)

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
ArgumentNullException
InvalidCastException

Autres ressources

Str, fonction
Liste des conversions
Format, fonction
Fonctions de conversion de types de données
Format, fonction
Val, fonction