Int64.TryParse Méthode

Définition

Convertit la représentation sous forme de chaîne d’un nombre en son entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

Surcharges

TryParse(String, IFormatProvider, Int64)

Tente d’analyser une chaîne en une valeur.

TryParse(ReadOnlySpan<Char>, Int64)

Convertit la représentation d’étendue d’un nombre en son équivalent entier signé 64 bits. Une valeur de retour indique si la conversion a réussi ou échoué.

TryParse(String, Int64)

Convertit la représentation sous forme de chaîne d’un nombre en son entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int64)

Tente d’analyser une étendue de caractères UTF-8 en une valeur.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Int64)

Tente d’analyser une étendue de caractères en une valeur.

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int64)

Tente d’analyser une étendue de caractères UTF-8 en une valeur.

TryParse(ReadOnlySpan<Byte>, Int64)

Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en son entier signé 64 bits équivalent.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64)

Convertit la représentation d’étendue d’un nombre dans un style et un format spécifique à la culture spécifiés en son entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

TryParse(String, NumberStyles, IFormatProvider, Int64)

Convertit la représentation sous forme de chaîne d’un nombre dans un style et un format spécifique à la culture spécifiés en entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

TryParse(String, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Tente d’analyser une chaîne en une valeur.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = IParsable<long>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out long result);
static member TryParse : string * IFormatProvider * int64 -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

s
String

Chaîne à analyser.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur s.

result
Int64

Lorsque cette méthode est retournée, contient le résultat de l’analyse réussie de s ou d’une valeur non définie en cas d’échec.

Retours

true si s a été analysé avec succès ; sinon, false.

S’applique à

TryParse(ReadOnlySpan<Char>, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Convertit la représentation d’étendue d’un nombre en son équivalent entier signé 64 bits. Une valeur de retour indique si la conversion a réussi ou échoué.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] long % result);
public static bool TryParse (ReadOnlySpan<char> s, out long result);
static member TryParse : ReadOnlySpan<char> * int64 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Long) As Boolean

Paramètres

s
ReadOnlySpan<Char>

Étendue contenant les caractères représentant le nombre à convertir.

result
Int64

Lorsque cette méthode est retournée, contient la valeur entière signée 64 bits équivalente au nombre contenu dans s, si la conversion a réussi ou zéro si la conversion a échoué. La conversion échoue si le paramètre s est null ou Empty, n’est pas du format correct, ou représente un nombre inférieur à Int64.MinValue ou supérieur à Int64.MaxValue. Ce paramètre est passé non initialisé ; toute valeur initialement fournie dans result sera remplacée.

Retours

true si s a été convertie avec succès ; sinon, false.

S’applique à

TryParse(String, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Convertit la représentation sous forme de chaîne d’un nombre en son entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] long % result);
public static bool TryParse (string s, out long result);
public static bool TryParse (string? s, out long result);
static member TryParse : string * int64 -> bool
Public Shared Function TryParse (s As String, ByRef result As Long) As Boolean

Paramètres

s
String

Chaîne contenant un nombre à convertir.

result
Int64

Lorsque cette méthode est retournée, contient la valeur entière signée 64 bits équivalente au nombre contenu dans s, si la conversion a réussi ou zéro si la conversion a échoué. La conversion échoue si le paramètre s est null ou Empty, n’est pas du format correct, ou représente un nombre inférieur à Int64.MinValue ou supérieur à Int64.MaxValue. Ce paramètre est passé non initialisé ; toute valeur initialement fournie dans result sera remplacée.

Retours

true si s a été convertie avec succès ; sinon, false.

Exemples

L’exemple suivant appelle la méthode Int64.TryParse(String, Int64) avec un certain nombre de valeurs de chaîne différentes.

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("160519");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      bool success = Int64.TryParse(value, out long number);
      if (success)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      else
      {
         if (value == null) value = "";
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '160519' to 160519.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100);' failed.
//       Attempted conversion of '01FA' failed.
open System

let tryToParse (value: string) =
    match Int64.TryParse value with
    | true, number ->
        printfn $"Converted '{value}' to {number}."
    | _ ->
        let value =
            if isNull value then 
                ""
            else
                value
        printfn $"Attempted conversion of '{value}' failed."

tryToParse null
tryToParse "160519"
tryToParse "9432.0"
tryToParse "16,667"
tryToParse "   -322   "
tryToParse "+4302"
tryToParse "(100);"
tryToParse "01FA"


// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '160519' to 160519.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100);' failed.
//       Attempted conversion of '01FA' failed.
Module StringParsing
   Public Sub Main()
      TryToParse(Nothing)
      TryToParse("160519")
      TryToParse("9432.0")
      TryToParse("16,667")
      TryToParse("   -322   ")
      TryToParse("+4302")
      TryToParse("(100)")
      TryToParse("01FA")
   End Sub
   
   Private Sub TryToParse(value As String)
      Dim number As Long
      Dim result As Boolean = Int64.TryParse(value, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Else
         If value Is Nothing Then value = "" 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value)
      End If     
   End Sub
End Module
' The example displays the following output to the console:
'       Attempted conversion of '' failed.
'       Converted '160519' to 160519.
'       Attempted conversion of '9432.0' failed.
'       Attempted conversion of '16,667' failed.
'       Converted '   -322   ' to -322.
'       Converted '+4302' to 4302.
'       Attempted conversion of '(100)' failed.
'       Attempted conversion of '01FA' failed.

Voici quelques-unes des chaînes que la méthode TryParse(String, Int64) ne peut pas convertir dans cet exemple :

  • "9432.0". La conversion échoue, car la chaîne ne peut pas contenir de séparateur décimal ; il doit contenir uniquement des chiffres intégraux.

  • "16,667". La conversion échoue, car la chaîne ne peut pas contenir de séparateurs de groupes ; il doit contenir uniquement des chiffres intégraux.

  • "(100)". La conversion échoue, car la chaîne ne peut pas contenir un signe négatif autre que celui défini par les propriétés NumberFormatInfo.NegativeSign et NumberFormatInfo.NumberNegativePattern de la culture actuelle.

  • « 01FA ». La conversion échoue, car la chaîne ne peut pas contenir de chiffres hexadécimaux ; il doit contenir uniquement des chiffres décimaux.

Remarques

La méthode TryParse est semblable à la méthode Parse, sauf que la méthode TryParse ne lève pas d’exception si la conversion échoue. Il élimine la nécessité d’utiliser la gestion des exceptions pour tester une FormatException en cas d's non valide et ne peut pas être analysé correctement.

Le paramètre s contient un certain nombre de formulaires :

[ws] [sign]digits[ws]

Les éléments entre crochets ([ et ]) sont facultatifs. Le tableau suivant décrit chaque élément.

Élément Description
ws Espace blanc facultatif.
signer Signe facultatif.
chiffres Séquence de chiffres allant de 0 à 9.

Le paramètre s est interprété à l’aide du style NumberStyles.Integer. Outre les chiffres décimaux, seuls les espaces de début et de fin avec un signe de début sont autorisés. Pour définir explicitement les éléments de style avec les informations de mise en forme spécifiques à la culture qui peuvent être présentes dans s, utilisez la méthode TryParse(String, NumberStyles, IFormatProvider, Int64).

Le paramètre s est analysé à l’aide des informations de mise en forme dans un objet NumberFormatInfo initialisé pour la culture système actuelle. Pour plus d’informations, consultez CurrentInfo.

Cette surcharge de la méthode TryParse interprète tous les chiffres du paramètre s comme des chiffres décimaux. Pour analyser la représentation sous forme de chaîne d’un nombre hexadécimal, appelez la surcharge TryParse(String, NumberStyles, IFormatProvider, Int64).

Voir aussi

S’applique à

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs

Tente d’analyser une étendue de caractères UTF-8 en une valeur.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = IUtf8SpanParsable<long>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out long result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * int64 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

utf8Text
ReadOnlySpan<Byte>

Étendue de caractères UTF-8 à analyser.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur utf8Text.

result
Int64

Lors du retour, contient le résultat de l’analyse réussie de utf8Text ou d’une valeur non définie en cas d’échec.

Retours

true si utf8Text a été analysé avec succès ; sinon, false.

S’applique à

TryParse(ReadOnlySpan<Char>, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Tente d’analyser une étendue de caractères en une valeur.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = ISpanParsable<long>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out long result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * int64 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

s
ReadOnlySpan<Char>

Étendue de caractères à analyser.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur s.

result
Int64

Lorsque cette méthode est retournée, contient le résultat de l’analyse réussie de s, ou d’une valeur non définie en cas d’échec.

Retours

true si s a été analysé avec succès ; sinon, false.

S’applique à

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs

Tente d’analyser une étendue de caractères UTF-8 en une valeur.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = System::Numerics::INumberBase<long>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out long result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * int64 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

utf8Text
ReadOnlySpan<Byte>

Étendue de caractères UTF-8 à analyser.

style
NumberStyles

Combinaison au niveau du bit des styles numériques qui peuvent être présents dans utf8Text.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur utf8Text.

result
Int64

Lors du retour, contient le résultat de l’analyse réussie de utf8Text ou d’une valeur non définie en cas d’échec.

Retours

true si utf8Text a été analysé avec succès ; sinon, false.

S’applique à

TryParse(ReadOnlySpan<Byte>, Int64)

Source:
Int64.cs
Source:
Int64.cs

Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en son entier signé 64 bits équivalent.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] long % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out long result);
static member TryParse : ReadOnlySpan<byte> * int64 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Long) As Boolean

Paramètres

utf8Text
ReadOnlySpan<Byte>

Étendue contenant les caractères UTF-8 représentant le nombre à convertir.

result
Int64

Lorsque cette méthode est retournée, contient la valeur entière signée 64 bits équivalente au nombre contenu dans utf8Text si la conversion a réussi ou zéro si la conversion a échoué. Ce paramètre est passé non initialisé ; toute valeur initialement fournie dans le résultat sera remplacée.

Retours

true si utf8Text a été convertie avec succès ; sinon, false.

S’applique à

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Convertit la représentation d’étendue d’un nombre dans un style et un format spécifique à la culture spécifiés en son entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result);
public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = System::Numerics::INumberBase<long>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out long result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out long result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * int64 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

s
ReadOnlySpan<Char>

Étendue contenant les caractères représentant le nombre à convertir. L’étendue est interprétée à l’aide du style spécifié par style.

style
NumberStyles

Combinaison de bits de valeurs d’énumération qui indique les éléments de style qui peuvent être présents dans s. Une valeur classique à spécifier est Integer.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur s.

result
Int64

Lorsque cette méthode est retournée, contient la valeur entière signée 64 bits équivalente au nombre contenu dans s, si la conversion a réussi ou zéro si la conversion a échoué. La conversion échoue si le paramètre s est null ou Empty, n’est pas dans un format conforme à style, ou représente un nombre inférieur à Int64.MinValue ou supérieur à Int64.MaxValue. Ce paramètre est passé non initialisé ; toute valeur initialement fournie dans result sera remplacée.

Retours

true si s a été convertie avec succès ; sinon, false.

S’applique à

TryParse(String, NumberStyles, IFormatProvider, Int64)

Source:
Int64.cs
Source:
Int64.cs
Source:
Int64.cs

Convertit la représentation sous forme de chaîne d’un nombre dans un style et un format spécifique à la culture spécifiés en entier signé 64 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result);
public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] long % result) = System::Numerics::INumberBase<long>::TryParse;
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out long result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out long result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * int64 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Long) As Boolean

Paramètres

s
String

Chaîne contenant un nombre à convertir. La chaîne est interprétée à l’aide du style spécifié par style.

style
NumberStyles

Combinaison de bits de valeurs d’énumération qui indique les éléments de style qui peuvent être présents dans s. Une valeur classique à spécifier est Integer.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur s.

result
Int64

Lorsque cette méthode est retournée, contient la valeur entière signée 64 bits équivalente au nombre contenu dans s, si la conversion a réussi ou zéro si la conversion a échoué. La conversion échoue si le paramètre s est null ou Empty, n’est pas dans un format conforme à style, ou représente un nombre inférieur à Int64.MinValue ou supérieur à Int64.MaxValue. Ce paramètre est passé non initialisé ; toute valeur initialement fournie dans result sera remplacée.

Retours

true si s a été convertie avec succès ; sinon, false.

Exceptions

style n’est pas une valeur NumberStyles.

-ou-

style n’est pas une combinaison de valeurs de AllowHexSpecifier et de HexNumber.

Exemples

L’exemple suivant appelle la méthode TryParse(String, NumberStyles, IFormatProvider, Int64) avec un certain nombre de valeurs de chaîne et de NumberStyles différentes.

using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;

      numericString = "106779";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);

      styles = NumberStyles.AllowLeadingSign;
      CallTryParse(numericString, styles);

      numericString = "301677-";
      CallTryParse(numericString, styles);

      styles = styles | NumberStyles.AllowTrailingSign;
      CallTryParse(numericString, styles);

      numericString = "$10634";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      styles = NumberStyles.Integer | NumberStyles.AllowCurrencySymbol;
      CallTryParse(numericString, styles);

      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593";
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);

      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles);

      numericString = "12E03";
      CallTryParse(numericString, styles);

      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);

      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      CultureInfo provider;

      // If currency symbol is allowed, use en-US culture.
      if ((styles & NumberStyles.AllowCurrencySymbol) > 0)
         provider = new CultureInfo("en-US");
      else
         provider = CultureInfo.InvariantCulture;

      bool success = Int64.TryParse(stringToConvert, styles,
                                   provider, out long number);
      if (success)
         Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
      else
         Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
   }
}
// The example displays the following output to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.
open System
open System.Globalization

let callTryParse (stringToConvert: string) styles =
    let provider =
        // If currency symbol is allowed, use en-US culture.
        if int (styles &&& NumberStyles.AllowCurrencySymbol) > 0 then
            CultureInfo "en-US"
        else
            CultureInfo.InvariantCulture

    match Int64.TryParse(stringToConvert, styles, provider) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."


[<EntryPoint>]
let main _ =
    let numericString = "106779"
    let styles = NumberStyles.Integer
    callTryParse numericString styles

    let numericString = "-30677"
    let styles = NumberStyles.None
    callTryParse numericString styles

    let styles = NumberStyles.AllowLeadingSign
    callTryParse numericString styles

    let numericString = "301677-"
    callTryParse numericString styles

    let styles = styles ||| NumberStyles.AllowTrailingSign
    callTryParse numericString styles

    let numericString = "$10634"
    let styles = NumberStyles.Integer
    callTryParse numericString styles

    let styles = NumberStyles.Integer ||| NumberStyles.AllowCurrencySymbol
    callTryParse numericString styles

    let numericString = "10345.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "10345.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "22,593"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowThousands
    callTryParse numericString styles

    let numericString = "12E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles

    let numericString = "12E03"
    callTryParse numericString styles

    let numericString = "80c1"
    callTryParse numericString NumberStyles.HexNumber

    let numericString = "0x80C1"
    callTryParse numericString NumberStyles.HexNumber

    0

// The example displays the following output to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106779"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.AllowLeadingSign
      CallTryParse(numericString, styles)
      
      numericString = "301677-"
      CallTryParse(numericString, styles)
      
      styles = styles Or NumberStyles.AllowTrailingSign
      CallTryParse(numericString, styles)
      
      numericString = "$10634"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.Integer Or NumberStyles.AllowCurrencySymbol
      CallTryParse(numericString, styles)

      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Long
      Dim provider As CultureInfo
      
      ' If currency symbol is allowed, use en-US culture.
      If CBool(styles And NumberStyles.AllowCurrencySymbol) Then
         provider = CultureInfo.CurrentCulture
      Else
         provider = New CultureInfo("en-US")
      End If
      
      Dim result As Boolean = Int64.TryParse(stringToConvert, styles, _
                                             provider, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '106779' to 106779.
'       Attempted conversion of '-30677' failed.
'       Converted '-30677' to -30677.
'       Attempted conversion of '301677-' failed.
'       Converted '301677-' to -301677.
'       Attempted conversion of '$10634' failed.
'       Converted '$10634' to 10634.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to 32961.
'       Attempted conversion of '0x80C1' failed.

Remarques

La méthode TryParse est semblable à la méthode Parse, sauf que la méthode TryParse ne lève pas d’exception si la conversion échoue. Elle élimine la nécessité d’utiliser la gestion des exceptions pour tester une FormatException en cas d’échec de l’analyse de s et ne peut pas être analysée correctement.

Le paramètre style définit les éléments de style (tels que l’espace blanc ou un signe positif ou négatif) autorisés dans le paramètre s pour que l’opération d’analyse réussisse. Il doit s’agir d’une combinaison d’indicateurs de bits de l’énumération NumberStyles. Selon la valeur de style, le paramètre s peut inclure les éléments suivants :

[ws] [$] [sign] [chiffres,]chiffres[.fractional_digits][e[sign]exponential_digits][ws]

Ou, si le paramètre style inclut NumberStyles.AllowHexSpecifier:

[ws]hexdigits[ws]

Les éléments entre crochets ([ et ]) sont facultatifs. Le tableau suivant décrit chaque élément.

Élément Description
ws Espace blanc facultatif. L’espace blanc peut apparaître au début de s si style inclut l’indicateur de NumberStyles.AllowLeadingWhite ou à la fin de s si style inclut l’indicateur de NumberStyles.AllowTrailingWhite.
$ Symbole monétaire propre à la culture. Sa position dans la chaîne est définie par la propriété CurrencyPositivePattern de l’objet NumberFormatInfo retourné par la méthode GetFormat du paramètre provider. Le symbole monétaire peut apparaître dans s si style inclut l’indicateur de NumberStyles.AllowCurrencySymbol.
signer Signe facultatif. Un symbole de signe peut apparaître dans s si style inclut les indicateurs de NumberStyles.AllowLeadingSign ou de NumberStyles.AllowTrailingSign.
chiffres

fractional_digits

exponential_digits
Séquence de chiffres comprises entre 0 et 9. Pour fractional_digits, seul le chiffre 0 est valide.
, Séparateur de milliers spécifiques à la culture. Le séparateur de milliers de la culture spécifiée par provider peut apparaître dans s si style inclut l’indicateur de NumberStyles.AllowThousands.
. Symbole décimal spécifique à la culture. Le symbole décimal de la culture spécifiée par provider peut apparaître dans s si style inclut l’indicateur de NumberStyles.AllowDecimalPoint.
e Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle. Le paramètre s peut représenter un nombre en notation exponentielle si style inclut l’indicateur de NumberStyles.AllowExponent.
hexdigits Séquence de chiffres hexadécimaux de 0 à f, ou de 0 à F.

Note

Les caractères NUL (U+0000) de fin dans s sont ignorés par l’opération d’analyse, quelle que soit la valeur de l’argument style.

Une chaîne avec des chiffres décimaux uniquement (qui correspond à l’indicateur de NumberStyles.None) analyse toujours correctement. La plupart des éléments de contrôle NumberStyles membres restants qui peuvent être, mais qui ne sont pas obligatoires pour être présents dans cette chaîne d’entrée. Le tableau suivant indique comment les membres de NumberStyles individuels affectent les éléments qui peuvent être présents dans s.

Valeurs NumberStyles non composites Éléments autorisés en plus des chiffres
NumberStyles.None Chiffres décimaux uniquement.
NumberStyles.AllowDecimalPoint Virgule décimale ( . ) et éléments fractional_digits. Toutefois, fractional_digits ne doit comporter qu’un ou plusieurs chiffres ou la méthode retourne false.
NumberStyles.AllowExponent Le paramètre s peut également utiliser la notation exponentielle. Le paramètre s doit représenter un entier dans la plage du type de données Int64 sans composant fractionnaire non nul.
NumberStyles.AllowLeadingWhite L’élément ws au début de s.
NumberStyles.AllowTrailingWhite L’élément ws à la fin de s.
NumberStyles.AllowLeadingSign Un signe peut apparaître avant chiffres.
NumberStyles.AllowTrailingSign Un signe peut apparaître après chiffres.
NumberStyles.AllowParentheses Signe élément sous la forme de parenthèses englobant la valeur numérique.
NumberStyles.AllowThousands Élément séparateur de milliers ( , ).
NumberStyles.AllowCurrencySymbol Élément $.
NumberStyles.Currency Tous les éléments. Le paramètre s ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.
NumberStyles.Float L’élément ws au début ou à la fin de s, signe au début de s, et le symbole décimal ( . ). Le paramètre s peut également utiliser la notation exponentielle.
NumberStyles.Number Les ws, signe, des milliers de séparateurs (,) et des éléments décimales (.).
NumberStyles.Any Tous les styles, sauf s ne peuvent pas représenter un nombre hexadécimal.

Si l’indicateur NumberStyles.AllowHexSpecifier est utilisé, s doit être une valeur hexadécimale sans préfixe. Par exemple, « C9AF3 » analyse correctement, mais « 0xC9AF3 » ne le fait pas. Les seuls autres indicateurs qui peuvent être présents dans style sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite. (L’énumération NumberStyles a un style composite, NumberStyles.HexNumber, qui inclut les deux indicateurs d’espace blanc.)

Le paramètre provider est une implémentation IFormatProvider, telle qu’un objet CultureInfo ou un objet NumberFormatInfo, dont GetFormat méthode retourne un objet NumberFormatInfo. L’objet NumberFormatInfo fournit des informations spécifiques à la culture sur le format de s. Si provider est null, l’objet NumberFormatInfo de la culture actuelle est utilisé.

Voir aussi

S’applique à