Int16.TryParse Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

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

Surcharges

Nom	Description
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)	Tente d’analyser une étendue de caractères UTF-8 en une valeur.
TryParse(ReadOnlySpan<Char>, Int16)	Convertit la représentation d’étendue d’un nombre dans un format spécifique à la culture en son entier signé 16 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.
TryParse(String, Int16)	Convertit la représentation sous forme de chaîne d’un nombre en son entier signé 16 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16)	Tente d’analyser une étendue de caractères en une valeur.
TryParse(String, IFormatProvider, Int16)	Tente d’analyser une chaîne en une valeur.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16)	Tente d’analyser une étendue de caractères UTF-8 en une valeur.
TryParse(ReadOnlySpan<Byte>, Int16)	Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en son équivalent entier signé 16 bits.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int16)	Convertit la représentation d’étendue d’un nombre dans un style et un format spécifique à la culture spécifiés en son équivalent entier signé 16 bits. Une valeur de retour indique si la conversion a réussi ou échoué.
TryParse(String, NumberStyles, IFormatProvider, Int16)	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é 16 bits équivalent. Une valeur de retour indique si la conversion a réussi ou échoué.

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)

Source:

Int16.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] short % result) = IUtf8SpanParsable<short>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * int16 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Short) 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

Int16

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

Retours

Boolean

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

TryParse(ReadOnlySpan<Char>, Int16)

Source:

Int16.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] short % result);

public static bool TryParse(ReadOnlySpan<char> s, out short result);

static member TryParse : ReadOnlySpan<char> * int16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Short) As Boolean

Paramètres

s

ReadOnlySpan<Char>

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

result

Int16

Lorsque cette méthode est retournée, contient la valeur entière signée 16 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 s paramètre est null ou Empty représente un nombre inférieur à Int16.MinValue ou supérieur à Int16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie result à l’origine sera remplacée.

Retours

Boolean

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

TryParse(String, Int16)

Source:

Int16.cs

Convertit la représentation sous forme de chaîne d’un nombre en son entier signé 16 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] short % result);

public static bool TryParse(string? s, out short result);

static member TryParse : string * int16 -> bool

Public Shared Function TryParse (s As String, ByRef result As Short) As Boolean

Paramètres

s

String

Chaîne contenant un nombre à convertir.

result

Int16

Lorsque cette méthode est retournée, contient la valeur entière signée 16 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 s paramètre est ou Emptyn’est null pas du format correct, ou représente un nombre inférieur à Int16.MinValue ou supérieur à Int16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie result à l’origine sera remplacée.

Retours

Boolean

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

Exemples

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

using System;

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

   private static void TryToParse(string value)
   {
      short number;
      bool result = Int16.TryParse(value, out number);
      if (result)
      {
         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 '16051' to 16051.
//       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 Int16.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 "16051"
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 '16051' to 16051.
//       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("16051")
      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 Int16
      Dim result As Boolean = Int16.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 '16051' to 16051.
'       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 TryParse(String, Int16) méthode 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 et NumberFormatInfo.NumberNegativePattern les propriétés de NumberFormatInfo.NegativeSign 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 Int16.TryParse(String, Int16) méthode diffère de la Int16.Parse(String) méthode en retournant une valeur booléenne qui indique si l’opération d’analyse a réussi au lieu de renvoyer la valeur analysée Int16 . Il élimine la nécessité d’utiliser la gestion des exceptions pour tester une FormatException exception dans le cas où elle s n’est pas valide et ne peut pas être analysée avec succès.

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

[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.
signe	Signe facultatif.
Chiffres	Séquence de chiffres allant de 0 à 9.

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

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

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

Voir aussi

• Parse(String)
• ToString()
• Analyse de chaînes numériques dans .NET
• exemple : Utilitaire de mise en forme WinForms .NET Core (C#)
• exemple : Utilitaire de mise en forme WinForms .NET Core (Visual Basic)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16)

Source:

Int16.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = ISpanParsable<short>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Short) 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

Int16

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

Retours

Boolean

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

TryParse(String, IFormatProvider, Int16)

Source:

Int16.cs

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

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IParsable<short>::TryParse;

public static bool TryParse(string? s, IFormatProvider? provider, out short result);

static member TryParse : string * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Short) 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

Int16

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

Retours

Boolean

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

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

Source:

Int16.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] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Paramètres

utf8Text

ReadOnlySpan<Byte>

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

style

NumberStyles

Combinaison de bits de 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

Int16

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

Retours

Boolean

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

TryParse(ReadOnlySpan<Byte>, Int16)

Source:

Int16.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 équivalent entier signé 16 bits.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] short % result);

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out short result);

static member TryParse : ReadOnlySpan<byte> * int16 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Short) As Boolean

Paramètres

utf8Text

ReadOnlySpan<Byte>

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

result

Int16

Lorsque cette méthode est retournée, contient la valeur entière signée 16 bits équivalente au nombre contenu si utf8Text 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

Boolean

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

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

Source:

Int16.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 équivalent entier signé 16 bits. 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] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) 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

Int16

Lorsque cette méthode est retournée, contient la valeur entière signée 16 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 s paramètre est ou Emptyn’est null pas dans un format conforme à style, ou représente un nombre inférieur à Int16.MinValue ou supérieur à Int16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie result à l’origine sera remplacée.

Retours

Boolean

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

TryParse(String, NumberStyles, IFormatProvider, Int16)

Source:

Int16.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é 16 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] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Short) 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

Int16

Lorsque cette méthode est retournée, contient la valeur entière signée 16 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 s paramètre est ou Emptyn’est null pas dans un format conforme à style, ou représente un nombre inférieur à Int16.MinValue ou supérieur à Int16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie result à l’origine sera remplacée.

Retours

Boolean

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

Exceptions

ArgumentException

style n’est pas une NumberStyles valeur.

-ou-

stylen’est pas une combinaison de AllowHexSpecifier valeurs.HexNumber

Exemples

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

using System;
using System.Globalization;

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

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

      numericString = "-30677";
      styles = NumberStyles.None;
      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)
   {
      short number;
      bool result = Int16.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 to the console:
//       Converted '10677' to 10677.
//       Attempted conversion of '-30677' failed.
//       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 -32575.
//       Attempted conversion of '0x80C1' failed.

open System
open System.Globalization

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

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

    let numericString = "-30677"
    let styles = NumberStyles.None
    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 '10677' to 10677.
//       Attempted conversion of '-30677' failed.
//       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 -32575.
//       Attempted conversion of '0x80C1' failed.

Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10677"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      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 Short
      Dim result As Boolean = Int16.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 '10677' to 10677.
'       Attempted conversion of '-30677' failed.
'       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 -32575.
'       Attempted conversion of '0x80C1' failed.

Remarques

La Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) méthode diffère de la Int16.Parse(String, NumberStyles, IFormatProvider) méthode en retournant une valeur booléenne qui indique si l’opération d’analyse a réussi au lieu de renvoyer la valeur analysée Int16 . Il élimine la nécessité d’utiliser la gestion des exceptions pour tester une FormatException exception dans le cas où elle s n’est pas valide et ne peut pas être analysée avec succès.

Le style paramètre définit les éléments de style (tels que l’espace blanc ou un signe positif ou négatif) autorisés dans le s paramètre 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 du style, le s paramètre peut inclure les éléments suivants :

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

Ou, si le style paramètre 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 NumberStyles.AllowLeadingWhite , ou à la fin de s si style inclut l’indicateur NumberStyles.AllowTrailingWhite .
$	Symbole monétaire propre à la culture. Sa position dans la chaîne est définie par la CurrencyPositivePattern propriété de l’objet NumberFormatInfo retourné par la GetFormat méthode du provider paramètre. Le symbole monétaire peut apparaître si sstyle l’indicateur NumberStyles.AllowCurrencySymbol est inclus.
signe	Signe facultatif.
Chiffres	Séquence de chiffres comprises entre 0 et 9.
,	Séparateur de milliers spécifiques à la culture. Le séparateur de milliers de la culture spécifiée provider peut apparaître s’il sstyle inclut l’indicateur NumberStyles.AllowThousands .
.	Symbole décimal spécifique à la culture. Le symbole décimal de la culture spécifiée peut provider apparaître si sstyle l’indicateur NumberStyles.AllowDecimalPoint est inclus.
fractional_digits	Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnels peuvent apparaître s uniquement si style l’indicateur NumberStyles.AllowDecimalPoint est inclus.
e	Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle. Le s paramètre peut représenter un nombre en notation exponentielle s’il style inclut l’indicateur NumberStyles.AllowExponent .
hexdigits	Séquence de chiffres hexadécimaux de 0 à f, ou de 0 à F.

Note

Les caractères s NUL (U+0000) de fin 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 NumberStyles.None ) analyse toujours correctement. La plupart des éléments de contrôle membres restants NumberStyles qui peuvent être, mais qui ne sont pas nécessaires pour être présents dans cette chaîne d’entrée. Le tableau suivant indique comment les membres individuels NumberStyles 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	Éléments . et fractional_digits . Toutefois, fractional_digits ne doit contenir qu’un ou plusieurs chiffres ou la méthode retourne false.
NumberStyles.AllowExponent	Le s paramètre peut également utiliser la notation exponentielle. Si s représente un nombre en notation exponentielle, il doit représenter un entier dans la plage du type de Int16 données sans composant fractionnaire non nul.
NumberStyles.AllowLeadingWhite	Élément ws au début de s.
NumberStyles.AllowTrailingWhite	Élément ws à la fin de s.
NumberStyles.AllowLeadingSign	Un signe peut apparaître avant les chiffres.
NumberStyles.AllowTrailingSign	Un signe peut apparaître après les chiffres.
NumberStyles.AllowParentheses	Élément de connexion sous la forme de parenthèses englobant la valeur numérique.
NumberStyles.AllowThousands	Élément ,
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ément ws au début ou à la fin de s, signe au début de s, et le symbole . Le s paramètre peut également utiliser la notation exponentielle.
NumberStyles.Number	Éléments ws, signe, séparateur de milliers (,) et virgule décimale (.).
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, « 9AF3 » analyse correctement, mais « 0x9AF3 » ne le fait pas. Les seuls autres indicateurs qui peuvent être présents sont styleNumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite. (L’énumération NumberStyles a un style composite, NumberStyles.HexNumberqui inclut les deux indicateurs d’espace blanc.)

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

Voir aussi

• Parse
• NumberStyles
• ToString()
• Analyse de chaînes numériques dans .NET