SByte.TryParse Méthode

Définition

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 8 bits signé.Converts the string representation of a number to its 8-bit signed integer equivalent. Un code de retour indique si la conversion a réussi ou a échoué.A return code indicates whether the conversion succeeded or failed.

Surcharges

TryParse(String, SByte)

Essaie de convertir la représentation sous forme de chaîne d'un nombre en son équivalent SByte et retourne une valeur indiquant si la conversion a réussi.Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, SByte)

Essaie de convertir la représentation sous forme de plage d’un nombre en son équivalent SByte et retourne une valeur indiquant si la conversion a réussi.Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, NumberStyles, IFormatProvider, SByte)

Essaie de convertir la représentation sous forme de chaîne d'un nombre ayant un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.Tries to convert the string representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

Essaie de convertir la représentation sous forme de plage d'un nombre ayant un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, SByte)

Important

Cette API n’est pas conforme CLS.

Essaie de convertir la représentation sous forme de chaîne d'un nombre en son équivalent SByte et retourne une valeur indiquant si la conversion a réussi.Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

Paramètres

s
String

Chaîne contenant un nombre à convertir.A string that contains a number to convert.

result
SByte

Quand cette méthode est retournée, contient la valeur de l'entier 8 bits signé équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué.When this method returns, contains the 8-bit signed integer value that is equivalent to the number contained in s if the conversion succeeded, or zero if the conversion failed. 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.The conversion fails if the s parameter is null or Empty, is not in the correct format, or represents a number that is less than MinValue or greater than MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.true if s was converted successfully; otherwise, false.

Attributs

Exemples

L’exemple suivant tente de convertir les chaînes d’un tableau en SByte valeurs en appelant la TryParse(String, SByte) méthode.The following example tries to convert the strings in an array to SByte values by calling the TryParse(String, SByte) method.

string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.
Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", "    3   ", _
                                  "(17)", "-17", "+12", "18-", "987", _
                                  "1,024", "  127 "}
Dim number As SByte
For Each numericString As String In numericStrings
   If SByte.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
   End If      
Next
' The example displays the following output to the console:
'       Cannot convert '-3.6' to an SByte.
'       Cannot convert '12.8' to an SByte.
'       Cannot convert '+16.7' to an SByte.
'       Converted '    3   ' to 3.
'       Cannot convert '(17)' to an SByte.
'       Converted '-17' to -17.
'       Converted '+12' to 12.
'       Cannot convert '18-' to an SByte.
'       Cannot convert '987' to an SByte.
'       Cannot convert '1,024' to an SByte.
'       Converted '  127 ' to 127.

Remarques

La SByte.TryParse(String, SByte) méthode est semblable SByte.Parse(String) à la méthode, sauf qu’elle ne lève pas d’exception en cas d’échec de la conversion.The SByte.TryParse(String, SByte) method is like the SByte.Parse(String) method, except that it does not throw an exception if the conversion fails. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si value n’est pas valide et ne peut pas être analysé avec succès.This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be successfully parsed.

Le s paramètre doit être la représentation sous forme de chaîne d’un nombre décimal au format suivant :The s parameter should be the string representation of a decimal number in the following form:

[ WS ] [ signe ] chiffres [ WS ][ ws ][ sign ] digits [ ws ]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Le tableau suivant décrit chaque élément.The following table describes each element.

ÉlémentElement DescriptionDescription
wsws Espace blanc facultatif.Optional white space.
signsign Signe facultatif.An optional sign. Les caractères de signe valides sont déterminés par les NumberFormatInfo.NegativeSign NumberFormatInfo.PositiveSign Propriétés et de la culture actuelle.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
chiffresdigits Séquence de chiffres décimaux compris entre 0 et 9.A sequence of decimal digits ranging from 0 to 9.

Notes

La chaîne spécifiée par le value paramètre ne peut pas contenir de séparateurs de groupes ou de séparateurs décimaux, et elle ne peut pas comporter de partie décimale.The string specified by the value parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Le s paramètre est interprété à l’aide du NumberStyles.Integer style.The s parameter is interpreted by using the NumberStyles.Integer style. En plus des chiffres décimaux, seuls les espaces de début et de fin avec un signe de début sont autorisés.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. 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 value , appelez la TryParse(String, NumberStyles, IFormatProvider, SByte) méthode.To explicitly define the style elements with the culture-specific formatting information that can be present in value, call the TryParse(String, NumberStyles, IFormatProvider, SByte) method.

Le s paramètre est analysé à l’aide des informations de mise en forme d’un NumberFormatInfo objet pour la culture actuelle.The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current culture. Pour plus d'informations, consultez NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

Cette surcharge interprète tous les chiffres du value paramètre comme des chiffres décimaux.This overload interprets all digits in the value parameter as decimal digits. Pour analyser la représentation sous forme de chaîne d’un nombre hexadécimal, appelez la surcharge à la TryParse(String, NumberStyles, IFormatProvider, SByte) place.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, SByte) overload instead.

Voir aussi

S’applique à

TryParse(ReadOnlySpan<Char>, SByte)

Important

Cette API n’est pas conforme CLS.

Essaie de convertir la représentation sous forme de plage d’un nombre en son équivalent SByte et retourne une valeur indiquant si la conversion a réussi.Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

Paramètres

s
ReadOnlySpan<Char>

Plage contenant les caractères représentant le nombre à convertir.A span containing the characters representing the number to convert.

result
SByte

Quand cette méthode est retournée, contient la valeur de l'entier 8 bits signé équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué.When this method returns, contains the 8-bit signed integer value that is equivalent to the number contained in s if the conversion succeeded, or zero if the conversion failed. 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.The conversion fails if the s parameter is null or Empty, is not in the correct format, or represents a number that is less than MinValue or greater than MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.true if s was converted successfully; otherwise, false.

Attributs

S’applique à

TryParse(String, NumberStyles, IFormatProvider, SByte)

Important

Cette API n’est pas conforme CLS.

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

Essaie de convertir la représentation sous forme de chaîne d'un nombre ayant un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.Tries to convert the string representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

Paramètres

s
String

Chaîne représentant un nombre à convertir.A string representing a number to convert.

style
NumberStyles

Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s.A bitwise combination of enumeration values that indicates the permitted format of s. Une valeur typique à spécifier est Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture sur s.An object that supplies culture-specific formatting information about s.

result
SByte

Quand cette méthode est retournée, contient la valeur de l'entier 8 bits signé équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué.When this method returns, contains the 8-bit signed integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. La conversion échoue si le paramètre s est null ou Empty, qu'il n'est pas dans un format conforme à style ou qu'il représente un nombre inférieur à MinValue ou supérieur à MaxValue.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.true if s was converted successfully; otherwise, false.

Attributs

Exceptions

style n’est pas une valeur NumberStyles.style is not a NumberStyles value.

- ou --or- style n’est pas une combinaison des valeurs AllowHexSpecifier et HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Exemples

L’exemple suivant appelle la TryParse(String, NumberStyles, IFormatProvider, SByte) méthode avec un certain nombre de valeurs et de chaînes différentes NumberStyles .The following example calls the TryParse(String, NumberStyles, IFormatProvider, SByte) method with a number of different string and NumberStyles values.

using System;
using System.Globalization;

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

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

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

      numericString = "10E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "12E-01"
      CallTryParse(numericString, styles)
          
      numericString = "12E01"
      CallTryParse(numericString, styles) 
      
      numericString = "C8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As SByte
      Dim result As Boolean = SByte.TryParse(stringToConvert, styles, _
                                             CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '106' to 106.
'       Attempted conversion of '-106' failed.
'       Converted '103.00' to 103.
'       Attempted conversion of '103.72' failed.
'       Converted '10E-01' to 1.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E01' to 120.
'       Converted 'C8' to -56.
'       Attempted conversion of '0x8C' failed.

Remarques

La TryParse(String, NumberStyles, IFormatProvider, SByte) méthode est semblable Parse(String, NumberStyles, IFormatProvider) à la méthode, sauf qu’elle ne lève pas d’exception en cas d’échec de la conversion.The TryParse(String, NumberStyles, IFormatProvider, SByte) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si value n’est pas valide et ne peut pas être analysé correctement.This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be parsed successfully.

Le style paramètre définit les éléments de style (tels qu’un espace blanc ou un signe positif ou négatif) qui sont autorisés dans le value paramètre pour que l’opération d’analyse aboutisse.The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the value parameter for the parse operation to succeed. Il doit s’agir d’une combinaison de bits indicateurs de l' NumberStyles énumération.It must be a combination of bit flags from the NumberStyles enumeration. Selon la valeur de style , le value paramètre peut inclure les éléments suivants :Depending on the value of style, the value parameter may include the following elements:

[ WS ] [ $ ] [ Sign ] [ digits ,] digits [. fractional_digits ] [E [ sign ] exponential_digits ] [ WS ][ ws ][ $ ][ sign ][ digits ,] digits [. fractional_digits ][E[ sign ] exponential_digits ][ ws ]

Si le style paramètre inclut AllowHexSpecifier , le value paramètre peut inclure les éléments suivants :If the style parameter includes AllowHexSpecifier, the value parameter may include the following elements:

[ WS ] hexdigits [ WS ][ ws ] hexdigits [ ws ]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Le tableau suivant décrit chaque élément.The following table describes each element.

ÉlémentElement DescriptionDescription
wsws Espace blanc facultatif.Optional white space. Un espace blanc peut apparaître au début de value si style comprend l' NumberStyles.AllowLeadingWhite indicateur, ou à la fin de value si style contient l' NumberStyles.AllowTrailingWhite indicateur.White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ Symbole monétaire propre à la culture.A culture-specific currency symbol. Sa position dans la chaîne est définie par la CurrencyPositivePattern propriété de l' NumberFormatInfo objet retourné par la GetFormat méthode du provider paramètre.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Le symbole monétaire peut apparaître dans value si style comprend l' NumberStyles.AllowCurrencySymbol indicateur.The currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Signe facultatif.An optional sign. Le signe peut apparaître au début de value si style comprend l' NumberStyles.AllowLeadingSign indicateur, et il peut apparaître à la fin de value si style contient l' NumberStyles.AllowTrailingSign indicateur.The sign can appear at the start of value if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingSign flag. Les parenthèses peuvent être utilisées dans value pour indiquer une valeur négative si style comprend l' NumberStyles.AllowParentheses indicateur.Parentheses can be used in value to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
chiffresdigits Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9.
,, Séparateur de groupe spécifique à la culture.A culture-specific group separator. Le séparateur de groupes de la culture spécifiée par provider peut apparaître dans value si style comprend l' NumberStyles.AllowThousands indicateur.The group separator of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. Symbole de virgule décimale propre à la culture.A culture-specific decimal point symbol. Le symbole de virgule décimale de la culture spécifiée par provider peut apparaître dans value si style comprend l' NumberStyles.AllowDecimalPoint indicateur.The decimal point symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Une ou plusieurs occurrences du chiffre 0.One or more occurrences of the digit 0. Les chiffres fractionnaires peuvent apparaître value uniquement dans si style comprend l' NumberStyles.AllowDecimalPoint indicateur.Fractional digits can appear in value only if style includes the NumberStyles.AllowDecimalPoint flag.
EE Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle (scientifique).The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Le value paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9. Le value paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Séquence de chiffres hexadécimaux comprise entre 0 et f, ou 0 et F.A sequence of hexadecimal digits from 0 through f, or 0 through 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.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Une chaîne avec des chiffres décimaux uniquement (qui correspond à l' NumberStyles.None indicateur) est toujours analysée avec succès.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. La plupart des membres restants NumberStyles contrôlent les éléments qui peuvent être présents, mais qui ne doivent pas être présents, dans cette chaîne d’entrée.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. Le tableau suivant indique comment les NumberStyles membres individuels affectent les éléments qui peuvent être présents dans value .The following table indicates how individual NumberStyles members affect the elements that may be present in value.

Valeurs non composites NumberStylesNon-composite NumberStyles values Éléments autorisés dans une valeur en plus des chiffresElements permitted in value in addition to digits
None Chiffres décimaux uniquement.Decimal digits only.
AllowDecimalPoint Les éléments de virgule décimale ( . ) et fractional_digits .The decimal point ( . ) and fractional_digits elements. Toutefois, fractional_digits doit être composé d’un ou de plusieurs chiffres 0, ou la méthode retourne false .However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Caractère « e » ou « E », qui indique la notation exponentielle, ainsi que les exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Si value représente un nombre en notation exponentielle, il ne peut pas avoir un composant différent de zéro et fractionnaire.If value represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Élément WS au début de value .The ws element at the start of value.
AllowTrailingWhite Élément WS à la fin de value .The ws element at the end of value.
AllowLeadingSign Élément signe avant les chiffres.The sign element before digits.
AllowTrailingSign Élément signe après les chiffres.The sign element after digits.
AllowParentheses Élément de signe sous forme de parenthèses entourant la valeur numérique.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands Élément de séparateur de groupes ( , ).The group separator ( , ) element.
AllowCurrencySymbol Élément Currency ( $ ).The currency ( $ ) element.
Currency Tous les éléments.All elements. Toutefois, value ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.However, value cannot represent a hexadecimal number or a number in exponential notation.
Float L’élément WS au début ou à la fin de value , se connecte au début de value et le symbole de virgule décimale ( . ).The ws element at the start or end of value, sign at the start of value, and the decimal point ( . ) symbol. Le value paramètre peut également utiliser la notation exponentielle.The value parameter can also use exponential notation.
Number Éléments WS , Sign , Separator Group ( , ) et Decimal point ( . ).The ws , sign , group separator ( , ), and decimal point ( . ) elements.
Any Tous les éléments.All elements. Toutefois, value ne peut pas représenter un nombre hexadécimal.However, value cannot represent a hexadecimal number.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, value doit être une valeur hexadécimale.If the NumberStyles.AllowHexSpecifier flag is used, value must be a hexadecimal value. Les chiffres hexadécimaux valides sont 0-9, a-f et A-F.Valid hexadecimal digits are 0-9, a-f, and A-F. Les seuls autres indicateurs qui peuvent être présents dans style sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite .The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération a un style composite, HexNumber , qui inclut les deux indicateurs d’espace blanc.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Notes

Si value est la représentation sous forme de chaîne d’un nombre hexadécimal, il ne peut pas être précédé d’une décoration (telle que 0x ou &h ) qui le différencie comme un nombre hexadécimal.If value is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. Cela provoque l’échec de la conversion.This causes the conversion to fail.

Le provider paramètre est une IFormatProvider implémentation.The provider parameter is an IFormatProvider implementation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de value .Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of value. Le provider paramètre peut être l’un des éléments suivants :The provider parameter can be any one of the following:

  • CultureInfoObjet qui représente la culture qui fournit les informations de mise en forme.A CultureInfo object that represents the culture that supplies formatting information. Sa GetFormat méthode retourne l' NumberFormatInfo objet qui fournit des informations de mise en forme numérique pour cette culture.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • NumberFormatInfoObjet qui fournit des informations de mise en forme numérique.A NumberFormatInfo object that provides numeric formatting information. (Son implémentation de GetFormat retourne simplement lui-même.)(Its implementation of GetFormat just returns itself.)

  • Objet personnalisé qui implémente IFormatProvider .A custom object that implements IFormatProvider. Sa GetFormat méthode instancie et retourne l' NumberFormatInfo objet qui fournit les informations de mise en forme.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Si provider est null , l' NumberFormatInfo objet pour la culture actuelle est utilisé.If provider is null, the NumberFormatInfo object for the current culture is used.

Voir aussi

S’applique à

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

Important

Cette API n’est pas conforme CLS.

Essaie de convertir la représentation sous forme de plage d'un nombre ayant un style et un format spécifique à la culture spécifiés en son équivalent SByte et retourne une valeur qui indique si la conversion a réussi.Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

Paramètres

s
ReadOnlySpan<Char>

Plage contenant les caractères représentant le nombre à convertir.A span containing the characters that represent the number to convert.

style
NumberStyles

Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s.A bitwise combination of enumeration values that indicates the permitted format of s. Une valeur typique à spécifier est Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture sur s.An object that supplies culture-specific formatting information about s.

result
SByte

Quand cette méthode est retournée, contient la valeur de l'entier 8 bits signé équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué.When this method returns, contains the 8-bit signed integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. La conversion échoue si le paramètre s est null ou Empty, qu'il n'est pas dans un format conforme à style ou qu'il représente un nombre inférieur à MinValue ou supérieur à MaxValue.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result sera remplacée.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retours

Boolean

true si la conversion de s est réussie ; sinon, false.true if s was converted successfully; otherwise, false.

Attributs

S’applique à