Byte.TryParse Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Essaie de convertir la représentation sous forme de chaîne d'un nombre en son équivalent Byte et retourne une valeur indiquant si la conversion a réussi.

Surcharges

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

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Byte)

Source:

Byte.cs

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

C#

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

Paramètres

utf8Text

ReadOnlySpan<Byte>

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

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture concernant utf8Text.

result

Byte

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

Retours

Boolean

true si utf8Text a été correctement analysé ; sinon, false.

TryParse(ReadOnlySpan<Char>, Byte)

Source:

Byte.cs

Essaie de convertir la représentation sous forme de plage d’un nombre en son équivalent Byte et retourne une valeur indiquant si la conversion a réussi.

C#

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

Paramètres

s

ReadOnlySpan<Char>

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

result

Byte

Quand cette méthode est retournée, contient la valeur Byte équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.

TryParse(String, Byte)

Source:

Byte.cs

Essaie de convertir la représentation sous forme de chaîne d'un nombre en son équivalent Byte et retourne une valeur indiquant si la conversion a réussi.

C#

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

Paramètres

s

String

Chaîne contenant un nombre à convertir.

result

Byte

Quand cette méthode est retournée, contient la valeur Byte équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.

Exemples

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

C#

using System;

public class ByteConversion
{
   public static void Main()
   {
      string[] byteStrings = { null, string.Empty, "1024",
                               "100.1", "100", "+100", "-100",
                               "000000000000000100", "00,100",
                               "   20   ", "FF", "0x1F" };

      foreach (var byteString in byteStrings)
      {
          CallTryParse(byteString);
      }
   }

   private static void CallTryParse(string stringToConvert)
   {
      byte byteValue;
      bool success = Byte.TryParse(stringToConvert, out byteValue);
      if (success)
      {
         Console.WriteLine("Converted '{0}' to {1}",
                        stringToConvert, byteValue);
      }
      else
      {
         Console.WriteLine("Attempted conversion of '{0}' failed.",
                           stringToConvert);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Attempted conversion of '' failed.
//       Attempted conversion of '1024' failed.
//       Attempted conversion of '100.1' failed.
//       Converted '100' to 100
//       Converted '+100' to 100
//       Attempted conversion of '-100' failed.
//       Converted '000000000000000100' to 100
//       Attempted conversion of '00,100' failed.
//       Converted '   20   ' to 20
//       Attempted conversion of 'FF' failed.
//       Attempted conversion of '0x1F' failed.

Remarques

La conversion échoue et la méthode retourne false si le s paramètre n’est pas au format correct, s’il est null ou String.Empty, ou s’il représente un nombre inférieur MinValue ou supérieur à MaxValue.

La Byte.TryParse(String, Byte) méthode est similaire à la Byte.Parse(String) méthode, sauf que TryParse(String, Byte) ne lève pas d’exception si la conversion échoue.

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

[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.
sign	Signe positif facultatif, comme spécifié par la NumberFormatInfo.PositiveSign propriété de la culture actuelle.
chiffres	Séquence de chiffres décimaux comprises entre 0 et 9.

Le s paramètre est interprété à l’aide du Integer style . En plus des chiffres décimaux de la valeur d’octet, seuls les espaces de début et de fin avec un signe de début sont autorisés. (Si le signe est présent, il doit s’agir d’un signe positif ou la méthode lève un OverflowException.) 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 Byte.Parse(String, NumberStyles, IFormatProvider) méthode .

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

Cette surcharge de la Byte.TryParse(String, Byte) 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 Byte.TryParse(String, NumberStyles, IFormatProvider, Byte) surcharge.

Voir aussi

• Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
• Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Byte)

Source:

Byte.cs

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

C#

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

Paramètres

s

ReadOnlySpan<Char>

Étendue des caractères à analyser.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture concernant s.

result

Byte

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

Retours

Boolean

true si s a été correctement analysé ; sinon, false.

TryParse(String, IFormatProvider, Byte)

Source:

Byte.cs

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

C#

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

Paramètres

s

String

Chaîne à analyser.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture concernant s.

result

Byte

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

Retours

Boolean

true si s a été correctement analysé ; sinon, false.

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

Source:

Byte.cs

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

C#

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

Paramètres

utf8Text

ReadOnlySpan<Byte>

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

style

NumberStyles

Combinaison de styles numériques au niveau du bit qui peut être présente dans utf8Text.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture concernant utf8Text.

result

Byte

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

Retours

Boolean

true si utf8Text a été correctement analysé ; sinon, false.

TryParse(ReadOnlySpan<Byte>, Byte)

Source:

Byte.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 non signé 8 bits.

C#

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

Paramètres

utf8Text

ReadOnlySpan<Byte>

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

result

Byte

Quand cette méthode est retournée, contient la valeur de l'entier signé 8 bits équivalente au nombre contenu dans utf8Text si la conversion a réussi, ou zéro si elle a échoué. Ce paramètre est passé sous forme non initialisée. Toute valeur fournie initialement dans le résultat sera remplacée.

Retours

Boolean

true si la conversion de utf8Text est réussie ; sinon, false.

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

Source:

Byte.cs

Convertit la représentation sous forme de plage d’un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente. Une valeur de retour indique si la conversion a réussi ou a échoué.

C#

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

Paramètres

s

ReadOnlySpan<Char>

Plage contenant les caractères représentant le nombre à convertir. La plage est interprétée en utilisant le style Integer.

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 typique à spécifier est Integer.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture sur s. Si provider est null, la culture actuelle du thread est utilisée.

result

Byte

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

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.

TryParse(String, NumberStyles, IFormatProvider, Byte)

Source:

Byte.cs

Convertit la représentation sous forme de chaîne d'un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente. Une valeur de retour indique si la conversion a réussi ou a échoué.

C#

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

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 typique à spécifier est Integer.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture sur s. Si provider est null, la culture actuelle du thread est utilisée.

result

Byte

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

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.

Exceptions

ArgumentException

style n’est pas une valeur NumberStyles.

- ou -

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

Exemples

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

C#

using System;
using System.Globalization;

public class ByteConversion2
{
   public static void Main()
   {
      string byteString;
      NumberStyles styles;

      byteString = "1024";
      styles = NumberStyles.Integer;
      CallTryParse(byteString, styles);

      byteString = "100.1";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(byteString, styles);

      byteString = "100.0";
      CallTryParse(byteString, styles);

      byteString = "+100";
      styles = NumberStyles.Integer | NumberStyles.AllowLeadingSign
               | NumberStyles.AllowTrailingSign;
      CallTryParse(byteString, styles);

      byteString = "-100";
      CallTryParse(byteString, styles);

      byteString = "000000000000000100";
      CallTryParse(byteString, styles);

      byteString = "00,100";
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(byteString, styles);

      byteString = "2E+3   ";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(byteString, styles);

      byteString = "FF";
      styles = NumberStyles.HexNumber;
      CallTryParse(byteString, styles);

      byteString = "0x1F";
      CallTryParse(byteString, styles);
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      Byte byteValue;
      bool result = Byte.TryParse(stringToConvert, styles,
                                  null as IFormatProvider, out byteValue);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}",
                        stringToConvert, byteValue);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.",
                           stringToConvert.ToString());
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '1024' failed.
//       Attempted conversion of '100.1' failed.
//       Converted '100.0' to 100
//       Converted '+100' to 100
//       Attempted conversion of '-100' failed.
//       Converted '000000000000000100' to 100
//       Converted '00,100' to 100
//       Attempted conversion of '2E+3   ' failed.
//       Converted 'FF' to 255
//       Attempted conversion of '0x1F' failed.

Remarques

La TryParse méthode est semblable à la Parse méthode , sauf que la TryParse méthode ne lève pas d’exception en cas d’échec de la conversion.

Le s paramètre est analysé à l’aide des informations de mise en forme dans un NumberFormatInfo objet fourni par le provider paramètre .

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

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

Ou, si le style paramètre inclut 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 le style inclut l’indicateur NumberStyles.AllowTrailingWhite .
$	Symbole monétaire spécifique à la culture. Sa position dans la chaîne est définie par la NumberFormatInfo.CurrencyPositivePattern propriété de l’objet NumberFormatInfo retournée par la GetFormat méthode du provider paramètre . Le symbole monétaire peut apparaître dans s si style inclut l’indicateur NumberStyles.AllowCurrencySymbol .
sign	Signe positif facultatif. (L’opération d’analyse échoue si un signe négatif est présent dans s.) Le signe peut apparaître au début de s si style inclut l’indicateur NumberStyles.AllowLeadingSign , ou à la fin de s si style inclut l’indicateur NumberStyles.AllowTrailingSign .
chiffres	Séquence de chiffres de 0 à 9.
.	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 NumberStyles.AllowDecimalPoint .
fractional_digits	Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnaires peuvent apparaître dans s uniquement si style inclut l’indicateur NumberStyles.AllowDecimalPoint .
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 si style inclut l’indicateur NumberStyles.AllowExponent .
hexdigits	Séquence de chiffres hexadécimaux de 0 à f ou de 0 à F.

Notes

Tous les caractères NUL de fin (U+0000) 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 au NumberStyles.None style) s’analyse toujours correctement. La plupart des membres restants NumberStyles contrôlent les éléments qui peuvent être mais qui ne doivent pas ê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 dans s en plus des chiffres
NumberStyles.None	Chiffres décimaux uniquement.
NumberStyles.AllowDecimalPoint	Éléments . et fractional_digits . Toutefois, fractional_digits ne doit comporter 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 Byte 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 positif peut apparaître avant les chiffres.
NumberStyles.AllowTrailingSign	Un signe positif peut apparaître après les chiffres.
NumberStyles.AllowParentheses	Bien que cet indicateur soit pris en charge, la méthode retourne false si des parenthèses sont présentes dans s.
NumberStyles.AllowThousands	Bien que le symbole de séparation de groupe puisse apparaître dans s, il ne peut être précédé que d’un ou plusieurs chiffres 0.
NumberStyles.AllowCurrencySymbol	Élément $.

Si l’indicateur NumberStyles.AllowHexSpecifier est utilisé, s doit être une valeur hexadécimale sans préfixe. Par exemple, « F3 » analyse correctement, mais « 0xF3 » 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 numérique composite, NumberStyles.HexNumber, qui 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.

Voir aussi

• ToString()
• MaxValue
• MinValue
• NumberStyles
• NumberFormatInfo
• IFormatProvider
• Analyse de chaînes numériques dans .NET