Partage via


SByte.TryParse Méthode

Définition

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

Surcharges

TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte)

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

TryParse(ReadOnlySpan<Char>, SByte)

Tente de convertir la représentation d’étendue d’un nombre en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

TryParse(String, SByte)

Tente de convertir la représentation sous forme de chaîne d’un nombre en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)

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

TryParse(String, IFormatProvider, SByte)

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

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

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

TryParse(ReadOnlySpan<Byte>, SByte)

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é 8 bits équivalent.

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

Tente de convertir la représentation d’étendue d’un nombre dans un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

TryParse(String, NumberStyles, IFormatProvider, SByte)

Tente de convertir 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 son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

TryParse(ReadOnlySpan<Byte>, IFormatProvider, SByte)

Source:
SByte.cs
Source:
SByte.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] System::SByte % result) = IUtf8SpanParsable<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As SByte) 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
SByte

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>, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

Important

Cette API n’est pas conforme CLS.

Tente de convertir la représentation d’étendue d’un nombre en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::SByte % result);
public static bool TryParse (ReadOnlySpan<char> s, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out sbyte result);
static member TryParse : ReadOnlySpan<char> * sbyte -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * sbyte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As SByte) As Boolean

Paramètres

s
ReadOnlySpan<Char>

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

result
SByte

Lorsque cette méthode est retournée, contient la valeur entière signée 8 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 au format correct ou représente un nombre inférieur à SByte.MinValue ou supérieur à SByte.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.

Attributs

S’applique à

TryParse(String, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

Important

Cette API n’est pas conforme CLS.

Tente de convertir la représentation sous forme de chaîne d’un nombre en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::SByte % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out sbyte result);
public static bool TryParse (string? s, out sbyte result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, out sbyte result);
[<System.CLSCompliant(false)>]
static member TryParse : string * sbyte -> bool
static member TryParse : string * sbyte -> bool
Public Shared Function TryParse (s As String, ByRef result As SByte) As Boolean

Paramètres

s
String

Chaîne qui contient un nombre à convertir.

result
SByte

Lorsque cette méthode est retournée, contient la valeur entière signée 8 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 au format correct ou représente un nombre inférieur à SByte.MinValue ou supérieur à SByte.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.

Attributs

Exemples

L’exemple suivant tente de convertir les chaînes d’un tableau en valeurs SByte en appelant la méthode TryParse(String, SByte).

string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.
open System

let numericStrings = 
    [| "-3.6"; "12.8"; "+16.7"; "    3   "; "(17)" 
       "-17"; "+12"; "18-"; "987"; "1,024"; "  127 " |]

for numericString in numericStrings do
    match SByte.TryParse numericString with 
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to an SByte."
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.
Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", "    3   ", _
                                  "(17)", "-17", "+12", "18-", "987", _
                                  "1,024", "  127 "}
Dim number As SByte
For Each numericString As String In numericStrings
   If SByte.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
   End If      
Next
' The example displays the following output to the console:
'       Cannot convert '-3.6' to an SByte.
'       Cannot convert '12.8' to an SByte.
'       Cannot convert '+16.7' to an SByte.
'       Converted '    3   ' to 3.
'       Cannot convert '(17)' to an SByte.
'       Converted '-17' to -17.
'       Converted '+12' to 12.
'       Cannot convert '18-' to an SByte.
'       Cannot convert '987' to an SByte.
'       Cannot convert '1,024' to an SByte.
'       Converted '  127 ' to 127.

Remarques

La méthode SByte.TryParse(String, SByte) est semblable à la méthode SByte.Parse(String), sauf qu’elle ne lève pas d’exception si la conversion échoue. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si value n’est pas valide et ne peut pas être analysé avec succès.

Le paramètre s doit être la représentation sous forme de chaîne d’un nombre décimal sous la forme suivante :

[ws] [sign]chiffres[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. Les caractères de signe valides sont déterminés par les propriétés NumberFormatInfo.NegativeSign et NumberFormatInfo.PositiveSign de la culture actuelle.
chiffres Séquence de chiffres décimaux allant de 0 à 9.

Note

La chaîne spécifiée par le paramètre value ne peut pas contenir de séparateurs de groupe ou de séparateur décimal, et elle ne peut pas avoir une partie décimale.

Le paramètre s est interprété à l’aide du style NumberStyles.Integer. En plus des 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 value, appelez la méthode TryParse(String, NumberStyles, IFormatProvider, SByte).

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

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

Voir aussi

S’applique à

TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = ISpanParsable<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As SByte) 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
SByte

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(String, IFormatProvider, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

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

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = IParsable<System::SByte>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out sbyte result);
static member TryParse : string * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As SByte) 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
SByte

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, SByte)

Source:
SByte.cs
Source:
SByte.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] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) 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
SByte

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>, SByte)

Source:
SByte.cs
Source:
SByte.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é 8 bits équivalent.

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

Paramètres

utf8Text
ReadOnlySpan<Byte>

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

result
SByte

Lorsque cette méthode est retournée, contient la valeur entière signée 8 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, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

Important

Cette API n’est pas conforme CLS.

Tente de convertir la représentation d’étendue d’un nombre dans un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

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

Paramètres

s
ReadOnlySpan<Char>

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

style
NumberStyles

Combinaison de valeurs d’énumération au niveau du bit qui indique le format autorisé de 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
SByte

Lorsque cette méthode est retournée, contient la valeur entière signée 8 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 à SByte.MinValue ou supérieur à SByte.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.

Attributs

S’applique à

TryParse(String, NumberStyles, IFormatProvider, SByte)

Source:
SByte.cs
Source:
SByte.cs
Source:
SByte.cs

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Int16.TryParse(String, Int16)

Tente de convertir 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 son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.

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

Paramètres

s
String

Chaîne représentant un nombre à convertir.

style
NumberStyles

Combinaison de valeurs d’énumération au niveau du bit qui indique le format autorisé de 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
SByte

Lorsque cette méthode est retournée, contient la valeur entière signée 8 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 à SByte.MinValue ou supérieur à SByte.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.

Attributs

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, SByte) avec un certain nombre de valeurs de chaîne et de NumberStyles différentes.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-106";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "103.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "12E-01";
      CallTryParse(numericString, styles);
          
      numericString = "12E01";
      CallTryParse(numericString, styles); 
      
      numericString = "C8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      sbyte number;
      bool result = SByte.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
      else
         Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
   }
}
// The example displays the following output:
//       Converted '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.
open System
open System.Globalization

let callTryParse (stringToConvert: string) styles =
    match SByte.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."

[<EntryPoint>]
let main _ =
    let numericString = "106"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-106"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "103.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles
    
    let numericString = "103.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "10E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles 
    
    let numericString = "12E-01"
    callTryParse numericString styles
        
    let numericString = "12E01"
    callTryParse numericString styles 
    
    let numericString = "C8"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8C"
    callTryParse numericString NumberStyles.HexNumber
    0

// The example displays the following output:
//       Converted '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-106"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "103.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "10E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "12E-01"
      CallTryParse(numericString, styles)
          
      numericString = "12E01"
      CallTryParse(numericString, styles) 
      
      numericString = "C8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As SByte
      Dim result As Boolean = SByte.TryParse(stringToConvert, styles, _
                                             CultureInfo.InvariantCulture, 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 '106' to 106.
'       Attempted conversion of '-106' failed.
'       Converted '103.00' to 103.
'       Attempted conversion of '103.72' failed.
'       Converted '10E-01' to 1.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E01' to 120.
'       Converted 'C8' to -56.
'       Attempted conversion of '0x8C' failed.

Remarques

La méthode TryParse(String, NumberStyles, IFormatProvider, SByte) est semblable à la méthode Parse(String, NumberStyles, IFormatProvider), sauf qu’elle ne lève pas d’exception si la conversion échoue. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si value n’est pas valide et ne peut pas être analysé 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 value 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 value peut inclure les éléments suivants :

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

Si le paramètre style inclut AllowHexSpecifier, le paramètre value peut inclure les éléments suivants :

[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 value si style inclut l’indicateur de NumberStyles.AllowLeadingWhite, ou à la fin de value 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 value si style inclut l’indicateur de NumberStyles.AllowCurrencySymbol.
signer Signe facultatif. Le signe peut apparaître au début de value si style inclut l’indicateur de NumberStyles.AllowLeadingSign et peut apparaître à la fin de value si style inclut l’indicateur de NumberStyles.AllowTrailingSign. Les parenthèses peuvent être utilisées dans value pour indiquer une valeur négative si style inclut l’indicateur de NumberStyles.AllowParentheses.
chiffres Séquence de chiffres comprises entre 0 et 9.
, Séparateur de groupe spécifique à la culture. Le séparateur de groupe de la culture spécifiée par provider peut apparaître dans value 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 value si style inclut l’indicateur de NumberStyles.AllowDecimalPoint.
fractional_digits Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnels peuvent apparaître dans value uniquement 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 (scientifique). Le paramètre value peut représenter un nombre en notation exponentielle si style inclut l’indicateur de NumberStyles.AllowExponent.
exponential_digits Séquence de chiffres comprises entre 0 et 9. Le paramètre value 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 présents, 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 value.

Valeurs NumberStyles non composites Éléments autorisés en valeur en plus des chiffres
None Chiffres décimaux uniquement.
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.
AllowExponent Caractère « e » ou « E », qui indique une notation exponentielle, ainsi que exponential_digits. Si value représente un nombre en notation exponentielle, il ne peut pas avoir un composant fractionnaire différent de zéro.
AllowLeadingWhite L’élément ws au début de value.
AllowTrailingWhite L’élément ws à la fin de value.
AllowLeadingSign Signe élément avant chiffres.
AllowTrailingSign Signe élément après chiffres.
AllowParentheses Signe élément sous la forme de parenthèses englobant la valeur numérique.
AllowThousands Élément séparateur de groupe (,).
AllowCurrencySymbol Élément currency ($).
Currency Tous les éléments. Toutefois, value ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.
Float L’élément ws au début ou à la fin de value, signe au début de value, et le symbole décimal (.). Le paramètre value peut également utiliser la notation exponentielle.
Number Éléments ws, sign, séparateur de groupe (,) et décimale (.).
Any Tous les éléments. Toutefois, value ne peut pas représenter un nombre hexadécimal.

Si l’indicateur NumberStyles.AllowHexSpecifier est utilisé, value doit être une valeur hexadécimale. Les chiffres hexadécimaux valides sont 0-9, a-f et A-F. 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, HexNumber, qui inclut les deux indicateurs d’espace blanc.)

Note

Si value est la représentation sous forme de chaîne d’un nombre hexadécimal, elle ne peut pas être précédée d’une décoration (telle que 0x ou &h) qui la différencie comme un nombre hexadécimal. Cela provoque l’échec de la conversion.

Le paramètre provider est une implémentation IFormatProvider. Sa méthode GetFormat retourne un objet NumberFormatInfo qui fournit des informations spécifiques à la culture sur le format de value. Le paramètre provider peut être l’un des éléments suivants :

  • Objet CultureInfo qui représente la culture qui fournit des informations de mise en forme. Sa méthode GetFormat retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme numériques pour cette culture.

  • Objet NumberFormatInfo qui fournit des informations de mise en forme numérique. (Son implémentation de GetFormat retourne simplement elle-même.)

  • Objet personnalisé qui implémente IFormatProvider. Sa méthode GetFormat instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.

Si provider est null, l’objet NumberFormatInfo de la culture actuelle est utilisé.

Voir aussi

S’applique à