Byte.Parse Méthode

Définition

Convertit la représentation sous forme de chaîne d'un nombre en sa représentation Byte équivalente.

Surcharges

Parse(String, NumberStyles, IFormatProvider)

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.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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.

Parse(String, NumberStyles)

Convertit la représentation d'un nombre sous forme de chaîne dans un style spécifié en son équivalent Byte.

Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en sa représentation Byte équivalente.

Parse(String, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre, ayant un format spécifique à la culture spécifié, en sa représentation Byte équivalente.

Parse(String, NumberStyles, IFormatProvider)

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.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public static byte Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
public static byte Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> byte
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Byte

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 spécifiques à la culture concernant le format de s. Si provider est null, la culture actuelle du thread est utilisée.

Retours

Byte

Valeur d'octet qui équivaut au nombre contenu dans s.

Exceptions

s a la valeur null.

Le format de s est incorrect.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.

  • ou -

s inclut des chiffres fractionnaires différents de zéro.

style n’est pas une valeur NumberStyles.

  • ou -

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

Exemples

L’exemple de code suivant analyse des représentations sous forme de chaîne de Byte valeurs avec cette surcharge de la Byte.Parse(String, NumberStyles, IFormatProvider) méthode.

NumberStyles style;
CultureInfo^ culture;
String^ value;
Byte number;

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles::Float;     
culture = CultureInfo::CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte::Parse(value, style, culture);
Console::WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo::CreateSpecificCulture("en-GB");
try
{
   number = Byte::Parse(value, style, culture);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", value); }   

value = "12.000";
number = Byte::Parse(value, style, culture);
Console::WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.
NumberStyles style;
CultureInfo culture;
string value;
byte number;

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo.CreateSpecificCulture("en-GB");
try
{
   number = Byte.Parse(value, style, culture);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

value = "12.000";
number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.
Dim style As NumberStyles
Dim culture As CultureInfo
Dim value As String
Dim number As Byte

' Parse number with decimals.
' NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float       
culture = CultureInfo.CreateSpecificCulture("fr-FR")
value = "12,000"

number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

culture = CultureInfo.CreateSpecificCulture("en-GB")
Try
   number = Byte.Parse(value, style, culture)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try      

value = "12.000"
number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' The example displays the following output to the console:
'       Converted '12,000' to 12.
'       Unable to parse '12,000'.
'       Converted '12.000' to 12.

Remarques

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

Web [$] [signe] chiffres [.fractional_digits] [e [signe] chiffres] [ws]

Ou, si le style paramètre comprend 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. Un espace blanc peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, ou à la fin de s si style contient l' NumberStyles.AllowTrailingWhite indicateur.
$ Symbole monétaire propre à la culture. Sa position dans la chaîne est définie par la NumberFormatInfo.CurrencyPositivePattern propriété de l' NumberFormatInfo objet retourné par la GetFormat méthode du provider paramètre. Le symbole monétaire peut apparaître dans s si style comprend l' NumberStyles.AllowCurrencySymbol indicateur.
sign Signe positif facultatif. (La méthode lève une exception OverflowException si un signe négatif est présent dans s .) Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur, ou à la fin de s si style contient l' NumberStyles.AllowTrailingSign indicateur.
chiffres Séquence de chiffres comprise entre 0 et 9.
. Symbole de virgule décimale propre à la culture. Le symbole de virgule décimale de la culture spécifiée par provider peut apparaître dans s si style comprend l' NumberStyles.AllowDecimalPoint indicateur.
fractional_digits Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnaires peuvent apparaître s uniquement dans si style comprend l' NumberStyles.AllowDecimalPoint indicateur.
Envoyer 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 contient l' NumberStyles.AllowExponent indicateur.
hexdigits Séquence de chiffres hexadécimaux comprise entre 0 et f, ou 0 et F.

Notes

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

Une chaîne avec des chiffres décimaux uniquement (qui correspond au NumberStyles.None style) est toujours analysée avec succès. La plupart des membres restants NumberStyles contrôlent les éléments qui peuvent être présents dans cette chaîne d’entrée, mais qui ne doivent pas l’être. Le tableau suivant indique comment les NumberStyles membres individuels 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’élément de langage . et fractional_digits éléments. Toutefois, fractional_digits doit être composé d’un ou de plusieurs chiffres 0, ou une OverflowException exception est levée.
NumberStyles.AllowExponent Le s paramètre peut également utiliser la notation exponentielle.
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 des chiffres.
NumberStyles.AllowParentheses Bien que cet indicateur soit pris en charge, l’utilisation de parenthèses dans s produit un OverflowException .
NumberStyles.AllowThousands Bien que le symbole de séparateur de groupes puisse apparaître dans s , il ne peut être précédé que par un ou plusieurs chiffres de 0.
NumberStyles.AllowCurrencySymbol $ Élément.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, s doit être une valeur hexadécimale sans préfixe. Par exemple, « F3 » est analysé avec succès, mais pas « 0xF3 ». Les seuls autres indicateurs qui peuvent être présents dans style sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite . (L' NumberStyles énumération a un style de nombre composite, NumberStyles.HexNumber , qui inclut les deux indicateurs d’espace blanc.)

Le provider paramètre est une IFormatProvider implémentation, telle qu’un NumberFormatInfo CultureInfo objet ou. Le provider paramètre fournit des informations propres à la culture utilisées lors de l’analyse. Si provider est null, la culture actuelle du thread est utilisée.

Voir aussi

S’applique à

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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.

public static byte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);
public static byte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> byte
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Byte

Paramètres

s
ReadOnlySpan<Char>

Étendue contenant les caractères représentant la valeur à convertir.

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 spécifiques à la culture concernant le format de s. Si provider est null, la culture actuelle du thread est utilisée.

Retours

Byte

Valeur d'octet qui équivaut au nombre contenu dans s.

S’applique à

Parse(String, NumberStyles)

Convertit la représentation d'un nombre sous forme de chaîne dans un style spécifié en son équivalent Byte.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static byte Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> byte
Public Shared Function Parse (s As String, style As NumberStyles) As Byte

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.

Retours

Byte

Valeur d'octet qui équivaut au nombre contenu dans s.

Exceptions

s a la valeur null.

Le format de s est incorrect.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.

  • ou -

s inclut des chiffres fractionnaires différents de zéro.

style n’est pas une valeur NumberStyles.

  • ou -

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

Exemples

L’exemple suivant analyse des représentations sous forme de chaîne de Byte valeurs avec la Byte.Parse(String, NumberStyles) méthode. La culture actuelle de l’exemple est en-US.

String^ value;
NumberStyles style;
Byte number;

// Parse value with no styles allowed.
style = NumberStyles::None;
value = " 241 ";
try
{
   number = Byte::Parse(value, style);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", value); }   

// Parse value with trailing sign.
style = NumberStyles::Integer | NumberStyles::AllowTrailingSign;
value = " 163+";
number = Byte::Parse(value, style);
Console::WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte::Parse(value, style);
Console::WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.
string value;
NumberStyles style;
byte number;

// Parse value with no styles allowed.
style = NumberStyles.None;
value = " 241 ";
try
{
   number = Byte.Parse(value, style);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

// Parse value with trailing sign.
style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
value = " 163+";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.
Dim value As String
Dim style As NumberStyles
Dim number As Byte

' Parse value with no styles allowed.
style = NumberStyles.None
value = " 241 "
Try
   number = Byte.Parse(value, style)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try
  
' Parse value with trailing sign.
style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
value = " 163+"
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

' Parse value with leading sign.
value = "   +253  "
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' This example displays the following output to the console:
'       Unable to parse ' 241 '.
'       Converted ' 163+' to 163.
'       Converted '   +253  ' to 253.

Remarques

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

Web [$] [signe] chiffres [.fractional_digits] [e [signe] chiffres] [ws]

Ou, si style comprend 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. Un espace blanc peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, ou à la fin de si le style comprend l' NumberStyles.AllowTrailingWhite indicateur.
$ Symbole monétaire propre à la culture. Sa position dans la chaîne est définie par la NumberFormatInfo.CurrencyPositivePattern propriété de la culture actuelle. Le symbole monétaire de la culture actuelle peut apparaître dans s si style comprend l' NumberStyles.AllowCurrencySymbol indicateur.
sign Signe positif facultatif. (La méthode lève une exception OverflowException si un signe négatif est présent dans s .) Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur, ou à la fin de s si style contient l' NumberStyles.AllowTrailingSign indicateur.
chiffres Séquence de chiffres comprise entre 0 et 9.
. Symbole de virgule décimale propre à la culture. Le symbole de virgule décimale de la culture actuelle peut apparaître dans s si style comprend l' NumberStyles.AllowDecimalPoint indicateur.
fractional_digits Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnaires peuvent apparaître s uniquement dans si style comprend l' NumberStyles.AllowDecimalPoint indicateur.
Envoyer 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 contient l' NumberStyles.AllowExponent indicateur.
hexdigits Séquence de chiffres hexadécimaux comprise entre 0 et f, ou 0 et F.

Notes

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

Une chaîne avec des chiffres décimaux uniquement (qui correspond au NumberStyles.None style) est toujours analysée avec succès. La plupart des membres restants NumberStyles contrôlent les éléments qui peuvent être présents dans cette chaîne d’entrée, mais qui ne doivent pas l’être. Le tableau suivant indique comment les NumberStyles membres individuels 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’élément de langage . et fractional_digits éléments. Toutefois, fractional_digits doit être composé d’un ou de plusieurs chiffres 0, ou une OverflowException exception est levée.
NumberStyles.AllowExponent Le s paramètre peut également utiliser la notation exponentielle.
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 des chiffres.
NumberStyles.AllowParentheses Bien que cet indicateur soit pris en charge, l’utilisation de parenthèses dans s produit un OverflowException .
NumberStyles.AllowThousands Bien que le symbole de séparateur de groupes puisse apparaître dans s , il ne peut être précédé que par un ou plusieurs chiffres de 0.
NumberStyles.AllowCurrencySymbol $ Élément.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, s doit être une valeur hexadécimale sans préfixe. Par exemple, « F3 » est analysé avec succès, mais pas « 0xF3 ». Les seuls autres indicateurs qui peuvent être combinés avec lui sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite . (L' NumberStyles énumération comprend un style de nombre composite, NumberStyles.HexNumber , qui comprend les deux indicateurs d’espace blanc.)

Le s paramètre est analysé à l’aide des informations de mise en forme d’un NumberFormatInfo objet initialisé pour la culture système en cours. Pour utiliser les informations de mise en forme d’une autre culture, appelez la Byte.Parse(String, NumberStyles, IFormatProvider) surcharge.

Voir aussi

S’applique à

Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en sa représentation Byte équivalente.

public:
 static System::Byte Parse(System::String ^ s);
public static byte Parse (string s);
static member Parse : string -> byte
Public Shared Function Parse (s As String) As Byte

Paramètres

s
String

Chaîne contenant un nombre à convertir. La chaîne est interprétée à l'aide du style Integer.

Retours

Byte

Valeur d'octet qui équivaut au nombre contenu dans s.

Exceptions

s a la valeur null.

Le format de s est incorrect.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.

Exemples

L’exemple suivant montre comment convertir une valeur de chaîne en valeur d’octet à l’aide de la Byte.Parse(String) méthode. La valeur d’octet obtenue est ensuite affichée sur la console.

String^ stringToConvert = " 162";
Byte byteValue;
try
{
   byteValue = Byte::Parse(stringToConvert);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}   
catch (FormatException^)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException^)
{
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue);
}  
// The example displays the following output to the console:
//       Converted ' 162' to 162.
string stringToConvert = " 162";
byte byteValue;
try
{
   byteValue = Byte.Parse(stringToConvert);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue);
}
// The example displays the following output to the console:
//       Converted ' 162' to 162.
Dim stringToConvert As String = " 162"
Dim byteValue As Byte
Try
   byteValue = Byte.Parse(stringToConvert)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  
' The example displays the following output to the console:
'       Converted ' 162' to 162.

Remarques

Le s paramètre contient un nombre au format suivant :

Web [signe] 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.
sign Signe positif ou négatif facultatif.
chiffres Séquence de chiffres allant de 0 à 9.

Le s paramètre est interprété à l’aide du NumberStyles.Integer style. En plus des chiffres décimaux de la valeur d’octet, seuls les espaces de début et de fin, ainsi qu’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 une exception OverflowException .) Pour définir explicitement les éléments de style qui peuvent être présents dans s , utilisez la Byte.Parse(String, NumberStyles) méthode ou Byte.Parse(String, NumberStyles, IFormatProvider) .

Le s paramètre est analysé à l’aide des informations de mise en forme d’un NumberFormatInfo objet initialisé pour la culture système en cours. Pour plus d'informations, consultez CurrentInfo. Pour analyser une chaîne à l’aide des informations de mise en forme d’une autre culture, utilisez la Byte.Parse(String, NumberStyles, IFormatProvider) méthode.

Voir aussi

S’applique à

Parse(String, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre, ayant un format spécifique à la culture spécifié, en sa représentation Byte équivalente.

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider);
public static byte Parse (string s, IFormatProvider provider);
public static byte Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> byte
Public Shared Function Parse (s As String, provider As IFormatProvider) As Byte

Paramètres

s
String

Chaîne contenant un nombre à convertir. La chaîne est interprétée à l'aide du style Integer.

provider
IFormatProvider

Objet qui fournit des informations d'analyse spécifiques à la culture concernant s. Si provider est null, la culture actuelle du thread est utilisée.

Retours

Byte

Valeur d'octet qui équivaut au nombre contenu dans s.

Exceptions

s a la valeur null.

Le format de s est incorrect.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.

Exemples

L’exemple suivant analyse des représentations sous forme de chaîne de Byte valeurs avec la Parse méthode.

String^ stringToConvert; 
Byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.
string stringToConvert;
byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.
Dim stringToConvert As String 
Dim byteValue As Byte

stringToConvert = " 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " + 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " +214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214 '.
'       Converted ' +214 ' to 214.

Remarques

Le s paramètre contient un nombre au format suivant :

Web [signe] 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.
sign Signe positif facultatif.
chiffres Séquence de chiffres allant de 0 à 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, ainsi qu’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 une exception OverflowException .) Pour définir explicitement les éléments de style avec les informations de mise en forme propres à 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 fourni par provider . Le provider paramètre est une IFormatProvider implémentation telle qu’un NumberFormatInfo CultureInfo objet ou. Le provider paramètre fournit des informations propres à la culture utilisées lors de l’analyse. Si provider est null, la culture actuelle du thread est utilisée.

Voir aussi

S’applique à