Byte.TryParse Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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(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>, 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, 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<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, 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.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::Byte % result);
public static bool TryParse (string s, out byte result);
public static bool TryParse (string? s, out byte result);
static member TryParse : string * byte -> bool
Public Shared Function TryParse (s As String, ByRef result As Byte) As Boolean
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
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.
using namespace System;
void main()
{
array<String^>^ byteStrings = gcnew array<String^> { nullptr, String::Empty,
"1024", "100.1", "100",
"+100", "-100", "000000000000000100",
"00,100", " 20 ", "FF", "0x1F" };
Byte byteValue;
for each (String^ byteString in byteStrings) {
bool result = Byte::TryParse(byteString, byteValue);
if (result)
Console::WriteLine("Converted '{0}' to {1}",
byteString, byteValue);
else
Console::WriteLine("Attempted conversion of '{0}' failed.",
byteString);
}
}
// The example displays the following output:
// 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.}
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.
open System
let callTryParse (stringToConvert: string) =
match Byte.TryParse stringToConvert with
| true, byteValue ->
printfn $"Converted '{stringToConvert}' to {byteValue}"
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
let byteStrings =
[ null; String.Empty; "1024"
"100.1"; "100"; "+100"; "-100"
"000000000000000100"; "00,100"
" 20 "; "FF"; "0x1F" ]
for byteString in byteStrings do
callTryParse byteString
// 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.
Module ByteConversion
Public Sub Main()
Dim byteStrings() As String = { Nothing, String.Empty, "1024",
"100.1", "100", "+100", "-100",
"000000000000000100", "00,100",
" 20 ", "FF", "0x1F"}
For Each byteString As String In byteStrings
CallTryParse(byteString)
Next
End Sub
Private Sub CallTryParse(stringToConvert As String)
Dim byteValue As Byte
Dim success As Boolean = Byte.TryParse(stringToConvert, byteValue)
If success Then
Console.WriteLine("Converted '{0}' to {1}", _
stringToConvert, byteValue)
Else
Console.WriteLine("Attempted conversion of '{0}' failed.", _
stringToConvert)
End If
End Sub
End Module
' 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 qu’elle 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, tel que spécifié par la NumberFormatInfo.PositiveSign propriété de la culture actuelle. |
chiffres | Séquence de chiffres décimaux allant de 0 à 9. |
Le s
paramètre est interprété à l’aide du Integer style. Outre les 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, s
utilisez la Byte.Parse(String, NumberStyles, IFormatProvider) méthode.
Le s
paramètre est analysé à l’aide des informations de mise en forme dans 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)
S’applique à
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.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::Byte % result);
public static bool TryParse (ReadOnlySpan<char> s, out byte result);
static member TryParse : ReadOnlySpan<char> * byte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Byte) As Boolean
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
true
si la conversion de s
est réussie ; sinon, false
.
S’applique à
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é.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Byte % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out byte result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out byte result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * byte -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Byte) 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 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 paramètre s
est null
ou Empty, n’est pas au format approprié ou représente un nombre inférieur à MinValue ou supérieur à MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.
Exceptions
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.
using namespace System;
using namespace System::Globalization;
void CallTryParse(String^ byteString, NumberStyles styles);
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);
}
void CallTryParse(String^ stringToConvert, NumberStyles styles)
{
Byte byteValue;
bool result = Byte::TryParse(stringToConvert, styles,
(IFormatProvider^) nullptr , byteValue);
if (result)
Console::WriteLine("Converted '{0}' to {1}",
stringToConvert, byteValue);
else
Console::WriteLine("Attempted conversion of '{0}' failed.",
stringToConvert);
}
// The example displays the following output:
// 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.}
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.
open System
open System.Globalization
let callTryParse (stringToConvert: string) (styles: NumberStyles) =
match Byte.TryParse(stringToConvert, styles, null) with
| true, byteValue ->
printfn $"Converted '{stringToConvert}' to {byteValue}"
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
[<EntryPoint>]
let main _ =
let byteString = "1024"
let styles = NumberStyles.Integer
callTryParse byteString styles
let byteString = "100.1"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse byteString styles
let byteString = "100.0"
callTryParse byteString styles
let byteString = "+100"
let styles = NumberStyles.Integer ||| NumberStyles.AllowLeadingSign ||| NumberStyles.AllowTrailingSign
callTryParse byteString styles
let byteString = "-100"
callTryParse byteString styles
let byteString = "000000000000000100"
callTryParse byteString styles
let byteString = "00,100"
let styles = NumberStyles.Integer ||| NumberStyles.AllowThousands
callTryParse byteString styles
let byteString = "2E+3 "
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse byteString styles
let byteString = "FF"
let styles = NumberStyles.HexNumber
callTryParse byteString styles
let byteString = "0x1F"
callTryParse byteString styles
0
// 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.
Imports System.Globalization
Module ByteConversion2
Public Sub Main()
Dim byteString As String
Dim styles As NumberStyles
byteString = "1024"
styles = NumberStyles.Integer
CallTryParse(byteString, styles)
byteString = "100.1"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(byteString, styles)
byteString = "100.0"
CallTryParse(byteString, styles)
byteString = "+100"
styles = NumberStyles.Integer Or NumberStyles.AllowLeadingSign _
Or NumberStyles.AllowTrailingSign
CallTryParse(byteString, styles)
byteString = "-100"
CallTryParse(byteString, styles)
byteString = "000000000000000100"
CallTryParse(byteString, styles)
byteString = "00,100"
styles = NumberStyles.Integer Or NumberStyles.AllowThousands
CallTryParse(byteString, styles)
byteString = "2E+3 "
styles = NumberStyles.Integer Or NumberStyles.AllowExponent
CallTryParse(byteString, styles)
byteString = "FF"
styles = NumberStyles.HexNumber
CallTryParse(byteString, styles)
byteString = "0x1F"
CallTryParse(byteString, styles)
End Sub
Private Sub CallTryParse(stringToConvert As String, styles As NumberStyles)
Dim byteValue As Byte
Dim result As Boolean = Byte.TryParse(stringToConvert, styles, Nothing, _
byteValue)
If result Then
Console.WriteLine("Converted '{0}' to {1}", _
stringToConvert, byteValue)
Else
If stringToConvert Is Nothing Then stringToConvert = ""
Console.WriteLine("Attempted conversion of '{0}' failed.", _
stringToConvert.ToString())
End If
End Sub
End Module
' 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 si la conversion échoue.
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 l’indicateur style NumberStyles.AllowLeadingWhite , ou à la fin de s’il 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é par la GetFormat méthode du provider paramètre. Le symbole monétaire peut apparaître s’il s 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 l’indicateur style NumberStyles.AllowLeadingSign , ou à la fin de s style 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 peut provider apparaître si s style l’indicateur NumberStyles.AllowDecimalPoint est inclus. |
fractional_digits | Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnaires peuvent apparaître uniquement s 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 0 à F. |
Notes
Les caractères NUL (U+0000) de fin sont s
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) analyse toujours correctement. La plupart des éléments de contrôle des membres restants NumberStyles qui peuvent être mais 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’élément de langage . et fractional_digits éléments. Toutefois, fractional_digits doit comporter un ou plusieurs chiffres ou la méthode retourne false . |
NumberStyles.AllowExponent | Le s paramètre peut également utiliser la notation exponentielle. S’il 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 fractionnel non zéro. |
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éparateur de groupe puisse apparaître dans s , il peut être précédé d’un ou plusieurs chiffres. |
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 style
sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite. (L’énumération NumberStyles a un style de nombre composite, NumberStyles.HexNumberqui inclut les deux indicateurs d’espace blanc.)
Le paramètre est une IFormatProvider implémentation, telle qu’un CultureInfo objet ou un NumberFormatInfo objet, dont GetFormat la provider
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
S’applique à
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é.
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Byte % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out byte result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out byte result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * byte -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Byte) As Boolean
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 paramètre s
est null
ou Empty, n’est pas au format approprié ou représente un nombre inférieur à MinValue ou supérieur à MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.