UInt32.Parse UInt32.Parse UInt32.Parse UInt32.Parse Method

Définition

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 32 bits.Converts the string representation of a number to its 32-bit unsigned integer equivalent.

Surcharges

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Convertit la représentation sous forme de chaîne d'un nombre dans un style spécifié en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified style to its 32-bit unsigned integer equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 32 bits.Converts the string representation of a number to its 32-bit unsigned integer equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre dans un format propre à la culture spécifié en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified culture-specific format to its 32-bit unsigned integer equivalent.

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Int64.Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent.

public:
 static System::UInt32 Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static uint Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> uint32
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As UInteger

Paramètres

s
String String String String

Chaîne représentant le nombre à convertir.A string representing the number to convert. La chaîne est interprétée à l'aide du style spécifié par le paramètre style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Combinaison de bits de valeurs d'énumération qui indique les éléments de style qui peuvent être présents dans s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Une valeur typique à spécifier est Integer.A typical value to specify is Integer.

provider
IFormatProvider IFormatProvider IFormatProvider 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.

Retours

Entier non signé 32 bits équivalant au nombre spécifié dans s.A 32-bit unsigned integer equivalent to the number specified in s.

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.

s n’est pas dans un format compatible avec style.s is not in a format compliant with style.

s représente un nombre qui est inférieur à MinValue ou supérieur à MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

- ou --or- s inclut des chiffres fractionnaires différents de zéro.s includes non-zero, fractional digits.

Exemples

L’exemple suivant utilise la Parse(String, NumberStyles, IFormatProvider) méthode pour convertir différentes représentations sous forme de chaîne de nombres en valeurs entières non signées 32 bits.The following example uses the Parse(String, NumberStyles, IFormatProvider) method to convert various string representations of numbers to 32-bit unsigned integer values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames= { "en-US", "fr-FR" };
      NumberStyles[] styles= { NumberStyles.Integer,
                               NumberStyles.Integer | NumberStyles.AllowDecimalPoint };
      string[] values = { "170209", "+170209.0", "+170209,0", "-103214.00",
                                 "-103214,00", "104561.1", "104561,1" };
      
      // Parse strings using each culture
      foreach (string cultureName in cultureNames)
      {
         CultureInfo ci = new CultureInfo(cultureName);
         Console.WriteLine("Parsing strings using the {0} culture", 
                           ci.DisplayName);
         // Use each style.
         foreach (NumberStyles style in styles)
         {
            Console.WriteLine("   Style: {0}", style.ToString());
            // Parse each numeric string.
            foreach (string value in values)
            {
               try {
                  Console.WriteLine("      Converted '{0}' to {1}.", value,
                                    UInt32.Parse(value, style, ci));
               }
               catch (FormatException) {
                  Console.WriteLine("      Unable to parse '{0}'.", value);
               }      
               catch (OverflowException) {
                  Console.WriteLine("      '{0}' is out of range of the UInt32 type.",
                                    value);
               }
            }
         }
      }                                    
   }
}
// The example displays the following output:
//       Parsing strings using the English (United States) culture
//          Style: Integer
//             Converted '170209' to 170209.
//             Unable to parse '+170209.0'.
//             Unable to parse '+170209,0'.
//             Unable to parse '-103214.00'.
//             Unable to parse '-103214,00'.
//             Unable to parse '104561.1'.
//             Unable to parse '104561,1'.
//          Style: Integer, AllowDecimalPoint
//             Converted '170209' to 170209.
//             Converted '+170209.0' to 170209.
//             Unable to parse '+170209,0'.
//             '-103214.00' is out of range of the UInt32 type.
//             Unable to parse '-103214,00'.
//             '104561.1' is out of range of the UInt32 type.
//             Unable to parse '104561,1'.
//       Parsing strings using the French (France) culture
//          Style: Integer
//             Converted '170209' to 170209.
//             Unable to parse '+170209.0'.
//             Unable to parse '+170209,0'.
//             Unable to parse '-103214.00'.
//             Unable to parse '-103214,00'.
//             Unable to parse '104561.1'.
//             Unable to parse '104561,1'.
//          Style: Integer, AllowDecimalPoint
//             Converted '170209' to 170209.
//             Unable to parse '+170209.0'.
//             Converted '+170209,0' to 170209.
//             Unable to parse '-103214.00'.
//             '-103214,00' is out of range of the UInt32 type.
//             Unable to parse '104561.1'.
//             '104561,1' is out of range of the UInt32 type.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR" }
      Dim styles() As NumberStyles = { NumberStyles.Integer, _
                                       NumberStyles.Integer Or NumberStyles.AllowDecimalPoint }
      Dim values() As String = { "170209", "+170209.0", "+170209,0", "-103214.00", _
                                 "-103214,00", "104561.1", "104561,1" }
      
      ' Parse strings using each culture
      For Each cultureName As String In cultureNames
         Dim ci As New CultureInfo(cultureName)
         Console.WriteLine("Parsing strings using the {0} culture", ci.DisplayName)
         ' Use each style.
         For Each style As NumberStyles In styles
            Console.WriteLine("   Style: {0}", style.ToString())
            ' Parse each numeric string.
            For Each value As String In values
               Try
                  Console.WriteLine("      Converted '{0}' to {1}.", value, _
                                    UInt32.Parse(value, style, ci))
               Catch e As FormatException
                  Console.WriteLine("      Unable to parse '{0}'.", value)   
               Catch e As OverflowException
                  Console.WriteLine("      '{0}' is out of range of the UInt32 type.", _
                                    value)         
               End Try
            Next
         Next
      Next                                    
   End Sub
End Module
' The example displays the following output:
'       Parsing strings using the English (United States) culture
'          Style: Integer
'             Converted '170209' to 170209.
'             Unable to parse '+170209.0'.
'             Unable to parse '+170209,0'.
'             Unable to parse '-103214.00'.
'             Unable to parse '-103214,00'.
'             Unable to parse '104561.1'.
'             Unable to parse '104561,1'.
'          Style: Integer, AllowDecimalPoint
'             Converted '170209' to 170209.
'             Converted '+170209.0' to 170209.
'             Unable to parse '+170209,0'.
'             '-103214.00' is out of range of the UInt32 type.
'             Unable to parse '-103214,00'.
'             '104561.1' is out of range of the UInt32 type.
'             Unable to parse '104561,1'.
'       Parsing strings using the French (France) culture
'          Style: Integer
'             Converted '170209' to 170209.
'             Unable to parse '+170209.0'.
'             Unable to parse '+170209,0'.
'             Unable to parse '-103214.00'.
'             Unable to parse '-103214,00'.
'             Unable to parse '104561.1'.
'             Unable to parse '104561,1'.
'          Style: Integer, AllowDecimalPoint
'             Converted '170209' to 170209.
'             Unable to parse '+170209.0'.
'             Converted '+170209,0' to 170209.
'             Unable to parse '-103214.00'.
'             '-103214,00' is out of range of the UInt32 type.
'             Unable to parse '104561.1'.
'             '104561,1' is out of range of the UInt32 type.

Remarques

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

Selon la valeur de style, le s paramètre peut inclure les éléments suivants:Depending on the value of style, the s parameter may include the following elements:

[WS] [$] [signe]chiffres[. chiffres_fractionnaires] [E [Sign]exponential_digits] [WS][ws][$][sign]digits[.fractional_digits][E[sign]exponential_digits][ws]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Si style inclut NumberStyles.AllowHexSpecifier, les paramètre peut inclure les éléments suivants:If style includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

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 s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, et il peut apparaître à la fin de s si style comprend l' NumberStyles.AllowTrailingWhite indicateur.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s 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é provider par la GetFormat méthode du paramètre.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object that is returned by the GetFormat method of the provider parameter. Le symbole monétaire peut apparaître dans s si style comprend l' NumberStyles.AllowCurrencySymbol indicateur.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Signe facultatif.An optional sign. (La méthode lève une OverflowException exception si s comprend un signe négatif et représente un nombre différent de zéro.) Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur, et il peut apparaître à la fin de s si style comprend l' NumberStyles.AllowTrailingSign indicateur.(The method throws an OverflowException if s includes a negative sign and represents a non-zero number.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear the end of s if style includes the NumberStyles.AllowTrailingSign flag. Les parenthèses peuvent être utilisées s dans pour indiquer une valeur négative style si comprend NumberStyles.AllowParentheses l’indicateur.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9.
.. Symbole de virgule décimale propre à la culture.A culture-specific decimal point symbol. Le symbole de virgule décimale de la culture actuelle s peut style apparaître dans NumberStyles.AllowDecimalPoint si comprend l’indicateur.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Une ou plusieurs occurrences du chiffre 0-9 si style incluent l' NumberStyles.AllowExponent indicateur, ou une ou plusieurs occurrences du chiffre 0 dans le cas contraire.One or more occurrences of the digit 0-9 if style includes the NumberStyles.AllowExponent flag, or one or more occurrences of the digit 0 if it does not. Les chiffres fractionnaires peuvent apparaître s uniquement dans style si comprend NumberStyles.AllowDecimalPoint l’indicateur.Fractional digits can appear in s 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 s paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The s 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 s paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The s 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 style de l’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 au NumberStyles.None style) est toujours analysée avec succès.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. La plupart des membres NumberStyles restants 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 sdans.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valeurs non composites NumberStylesNon-composite NumberStyles values Éléments autorisés dans s en plus des chiffresElements permitted in s in addition to digits
NumberStyles.None Chiffres décimaux uniquement.Decimal digits only.
NumberStyles.AllowDecimalPoint Éléments de virgule décimale (.) et de chiffres.The decimal point (.) and fractional_digits elements. Toutefois, si style n’inclut pas l' NumberStyles.AllowExponent indicateur, les chiffres des chiffres doivent se composer d’un ou de plusieurs chiffres 0 OverflowException ; sinon, une exception est levée.However, if style does not include the NumberStyles.AllowExponent flag, fractional_digits must consist of only one or more 0 digits; otherwise, an OverflowException is thrown.
NumberStyles.AllowExponent Le caractère « e » ou « E », qui indique la notation exponentielle, avec exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite Élément WS au début de s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Élément WS à la fin de s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Signe avant les chiffres.A sign before digits.
NumberStyles.AllowTrailingSign Signe après les chiffres.A sign after digits.
NumberStyles.AllowParentheses Parenthèses avant et après les chiffres pour indiquer une valeur négative.Parentheses before and after digits to indicate a negative value.
NumberStyles.AllowThousands Élément de séparateur de groupes (,).The group separator (,) element.
NumberStyles.AllowCurrencySymbol Élément Currency ($).The currency ($) element.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, s doit être une valeur hexadécimale.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Les seuls autres indicateurs qui peuvent être combinés avec lui sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite.The only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération comprend un style de nombre NumberStyles.HexNumbercomposite,, qui comprend les deux indicateurs d’espace blanc.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Notes

Si le s paramètre est la représentation sous forme de chaîne d’un nombre hexadécimal, il ne peut pas être précédé d’une 0x décoration &h(telle que ou) qui le différencie comme un nombre hexadécimal.If the s parameter 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. L’opération d’analyse lève alors une exception.This causes the parse operation to throw an exception.

Le provider paramètre est une IFormatProvider implémentation dont GetFormat la méthode retourne NumberFormatInfo un objet qui fournit des informations spécifiques à la culture sur sle format de.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Il existe trois façons d’utiliser le provider paramètre pour fournir des informations de mise en forme personnalisées à l’opération d’analyse:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Vous pouvez transmettre l’objet NumberFormatInfo réel qui fournit les informations de mise en forme.You can pass the actual NumberFormatInfo object that provides formatting information. (Son implémentation de GetFormat retourne simplement lui-même.)(Its implementation of GetFormat simply returns itself.)

  • Vous pouvez passer un CultureInfo objet qui spécifie la culture dont la mise en forme doit être utilisée.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. Sa NumberFormat propriété fournit des informations de mise en forme.Its NumberFormat property provides formatting information.

  • Vous pouvez passer une implémentation IFormatProvider personnalisée.You can pass a custom IFormatProvider implementation. Sa GetFormat méthode doit instancier et retourner NumberFormatInfo l’objet qui fournit les informations de mise en forme.Its GetFormat method must instantiate and return 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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Important

Cette API n’est pas conforme CLS.

[System.CLSCompliant(false)]
public static uint Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> uint32
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As UInteger

Paramètres

Retours

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Int64.Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre dans un style spécifié en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified style to its 32-bit unsigned integer equivalent.

public:
 static System::UInt32 Parse(System::String ^ s, System::Globalization::NumberStyles style);
[System.CLSCompliant(false)]
public static uint Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> uint32
Public Shared Function Parse (s As String, style As NumberStyles) As UInteger

Paramètres

s
String String String String

Chaîne représentant le nombre à convertir.A string representing the number to convert. La chaîne est interprétée à l'aide du style spécifié par le paramètre style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

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

Retours

Entier non signé 32 bits équivalant au nombre spécifié dans s.A 32-bit unsigned integer equivalent to the number specified in s.

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.

s n’est pas dans un format compatible avec style.s is not in a format compliant with style.

s représente un nombre qui est inférieur à MinValue ou supérieur à MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

ou-or- s inclut des chiffres fractionnaires différents de zéro.s includes non-zero, fractional digits.

Exemples

L’exemple suivant tente d’analyser chaque élément d’un tableau de chaînes à l’aide de NumberStyles plusieurs valeurs.The following example tries to parse each element in a string array by using a number of NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values= { " 214309 ", "1,064,181", "(0)", "10241+", " + 21499 ", 
                         " +21499 ", "122153.00", "1e03ff", "91300.0e-2" };
      NumberStyles whitespace =  NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite;
      NumberStyles[] styles= { NumberStyles.None, whitespace, 
                               NumberStyles.AllowLeadingSign | NumberStyles.AllowTrailingSign | whitespace, 
                               NumberStyles.AllowThousands | NumberStyles.AllowCurrencySymbol, 
                               NumberStyles.AllowExponent | NumberStyles.AllowDecimalPoint };

      // Attempt to convert each number using each style combination.
      foreach (string value in values)
      {
         Console.WriteLine("Attempting to convert '{0}':", value);
         foreach (NumberStyles style in styles)
         {
            try {
               uint number = UInt32.Parse(value, style);
               Console.WriteLine("   {0}: {1}", style, number);
            }   
            catch (FormatException) {
               Console.WriteLine("   {0}: Bad Format", style);
            }   
            catch (OverflowException)
            {
               Console.WriteLine("   {0}: Overflow", value);         
            }         
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    Attempting to convert ' 214309 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: 214309
//       Integer, AllowTrailingSign: 214309
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '1,064,181':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: 1064181
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '(0)':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '10241+':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 10241
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' + 21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' +21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 21499
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '122153.00':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 122153
//    
//    Attempting to convert '1e03ff':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '91300.0e-2':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 913
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { " 214309 ", "1,064,181", "(0)", "10241+", _
                                 " + 21499 ", " +21499 ", "122153.00", _
                                 "1e03ff", "91300.0e-2" }
      Dim whitespace As NumberStyles =  NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite
      Dim styles() As NumberStyles = { NumberStyles.None, _
                                       whitespace, _
                                       NumberStyles.AllowLeadingSign Or NumberStyles.AllowTrailingSign Or whitespace, _
                                       NumberStyles.AllowThousands Or NumberStyles.AllowCurrencySymbol, _
                                       NumberStyles.AllowExponent Or NumberStyles.AllowDecimalPoint }

      ' Attempt to convert each number using each style combination.
      For Each value As String In values
         Console.WriteLine("Attempting to convert '{0}':", value)
         For Each style As NumberStyles In styles
            Try
               Dim number As UInteger = UInt32.Parse(value, style)
               Console.WriteLine("   {0}: {1}", style, number)
            Catch e As FormatException
               Console.WriteLine("   {0}: Bad Format", style)
            Catch e As OverflowException
               Console.WriteLine("   {0}: Overflow", value)         
            End Try         
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Attempting to convert ' 214309 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: 214309
'       Integer, AllowTrailingSign: 214309
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '1,064,181':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: 1064181
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '(0)':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '10241+':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 10241
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' + 21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' +21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 21499
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '122153.00':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 122153
'    
'    Attempting to convert '1e03ff':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '91300.0e-2':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 913

Remarques

Le style paramètre définit les éléments de style (tels que les espaces blancs, le symbole de signe positif ou négatif, le symbole de séparateur de groupes ou le symbole de virgule décimale s ) qui sont autorisés dans le paramètre pour que l’opération d’analyse aboutisse.The style parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the s parameter for the parse operation to succeed. styledoit être une combinaison d’indicateurs binaires de NumberStyles l’énumération.style must be a combination of bit flags from the NumberStyles enumeration. Le style paramètre rend cette surcharge de méthode utile s quand contient la représentation sous forme de chaîne d’une valeur hexadécimale, lorsque le système de nombres ( s décimal ou hexadécimal) représenté par est connu uniquement au moment de l’exécution, ou lorsque vous souhaitez interdire l’espace blanc ou un symbole de signe sdans.The style parameter makes this method overload useful when s contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by s is known only at run time, or when you want to disallow white space or a sign symbol in s.

Selon la valeur de style, le s paramètre peut inclure les éléments suivants:Depending on the value of style, the s parameter may include the following elements:

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

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Si style comprend NumberStyles.AllowHexSpecifier, les paramètre peut contenir les éléments suivants:If style includes NumberStyles.AllowHexSpecifier, the s parameter may contain the following elements:

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

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 s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, et il peut apparaître à la fin de s si style contient l' NumberStyles.AllowTrailingWhite indicateur.White space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s 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 les NumberFormatInfo.CurrencyNegativePattern propriétés NumberFormatInfo.CurrencyPositivePattern et de la culture actuelle.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. Le symbole monétaire de la culture actuelle peut apparaître s dans style si comprend NumberStyles.AllowCurrencySymbol l’indicateur.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Signe facultatif.An optional sign. Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur, et il peut apparaître à la fin de s si style contient l' NumberStyles.AllowTrailingSign indicateur.The sign can appear at the start of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Les parenthèses peuvent être utilisées s dans pour indiquer une valeur négative style si comprend NumberStyles.AllowParentheses l’indicateur.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Toutefois, le symbole de signe négatif ne peut être utilisé qu’avec zéro ; Sinon, la méthode lève une OverflowExceptionexception.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9. Pour les chiffres_fractionnaires, seul le chiffre 0 est valide.For fractional_digits, only the digit 0 is valid.
,, Symbole de séparateur de groupe spécifique à la culture.A culture-specific group separator symbol. Le séparateur de groupes de la culture actuelle peut s apparaître style dans si NumberStyles.AllowThousands comprend l’indicateur.The current culture's group separator can appear in s 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 actuelle s peut style apparaître dans NumberStyles.AllowDecimalPoint si comprend l’indicateur.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag. Seul le chiffre 0 peut apparaître sous la forme d’un chiffre fractionnaire pour que l’opération d’analyse aboutisse. Si les chiffres_fractionnaires incluent tout autre chiffre, FormatException une exception est levée.Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, a FormatException is thrown.
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 s paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The s 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 style de l’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 uniquement (qui correspond au NumberStyles.None style) est toujours analysée avec succès.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. La plupart des membres NumberStyles restants contrôlent les éléments qui peuvent être présents, mais qui ne doivent pas être présents, dans la 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 the input string. Le tableau suivant indique comment les NumberStyles membres individuels affectent les éléments qui peuvent être présents sdans.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

ValeurNumberStylesNumberStyles value Éléments autorisés dans s en plus des chiffresElements permitted in s in addition to digits
None Élément digits uniquement.The digits element only.
AllowDecimalPoint Éléments virgule décimale (.) et chiffres fractionnaires .The decimal point (.) and fractional-digits elements.
AllowExponent Le caractère « e » ou « E », qui indique la notation exponentielle, avec exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
AllowLeadingWhite Élément WS au début de s.The ws element at the start of s.
AllowTrailingWhite Élément WS à la fin de s.The ws element at the end of s.
AllowLeadingSign Élément signe au début de s.The sign element at the start of s.
AllowTrailingSign Élément signe à la fin de s.The sign element at the end of s.
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, s ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float L’élément WS au début ou à la fin sde, se connecte au sdébut de et le symbole de virgule décimale (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Le s paramètre peut également utiliser la notation exponentielle.The s parameter can also use exponential notation.
Number Les wséléments sign,, de séparateur de groupes (,) et de virgule décimale (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Tous les éléments.All elements. Toutefois, s ne peut pas représenter un nombre hexadécimal.However, s cannot represent a hexadecimal number.

Contrairement aux autres NumberStyles valeurs, qui permettent, mais ne requièrent pas, la présence d’éléments de style particuliers sdans, NumberStyles.AllowHexSpecifier la valeur de style signifie que les caractères numériques s individuels dans sont toujours interprétés comme caractères hexadécimaux.Unlike the other NumberStyles values, which allow for, but do not require, the presence of particular style elements in s, the NumberStyles.AllowHexSpecifier style value means that the individual numeric characters in s are always interpreted as hexadecimal characters. Les caractères hexadécimaux valides sont 0-9, A-F et a-f.Valid hexadecimal characters are 0-9, A-F, and a-f. Un préfixe, tel que « 0x », n’est pas autorisé.A prefix, such as "0x", is not allowed. Les seuls autres indicateurs qui peuvent être combinés avec le style paramètre sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération comprend un style de nombre NumberStyles.HexNumbercomposite,, qui comprend les deux indicateurs d’espace blanc.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Les seuls autres indicateurs qui peuvent être combinés avec le style paramètre sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération comprend un style de nombre NumberStyles.HexNumbercomposite,, qui comprend les deux indicateurs d’espace blanc.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Notes

Si s est la représentation sous forme de chaîne d’un nombre hexadécimal, il ne peut pas être précédé d’une 0x décoration &h(telle que ou) qui le différencie comme un nombre hexadécimal.If s 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 s paramètre est analysé à l’aide des informations de mise en forme NumberFormatInfo d’un objet initialisé pour la culture système en cours.The s parameter is parsed by using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Pour spécifier la culture dont les informations de mise en forme sont utilisées pour l’opération d' Parse(String, NumberStyles, IFormatProvider) analyse, appelez la surcharge.To specify the culture whose formatting information is used for the parse operation, call the Parse(String, NumberStyles, IFormatProvider) overload.

Voir aussi

Parse(String) Parse(String) Parse(String) Parse(String)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Int64.Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 32 bits.Converts the string representation of a number to its 32-bit unsigned integer equivalent.

public:
 static System::UInt32 Parse(System::String ^ s);
[System.CLSCompliant(false)]
public static uint Parse (string s);
static member Parse : string -> uint32
Public Shared Function Parse (s As String) As UInteger

Paramètres

s
String String String String

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

Retours

Entier non signé 32 bits équivalent au nombre contenu dans s.A 32-bit unsigned integer equivalent to the number contained in s.

Exceptions

Le paramètre s a la valeur null.The s parameter is null.

Le format du paramètre s n’est pas correct.The s parameter is not of the correct format.

Le paramètre s représente un nombre inférieur à MinValue ou supérieur à MaxValue.The s parameter represents a number that is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant utilise la Parse(String) méthode pour analyser un tableau de valeurs de chaîne.The following example uses the Parse(String) method to parse an array of string values.

string[] values = { "+13230", "-0", "1,390,146", "$190,235,421,127",
                    "0xFA1B", "163042", "-10", "2147483648", 
                    "14065839182", "16e07", "134985.0", "-12034" };
foreach (string value in values)
{
   try {
      uint number = UInt32.Parse(value); 
      Console.WriteLine("{0} --> {1}", value, number);
   }
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);   
   }  
}
// The example displays the following output:
//       +13230 --> 13230
//       -0 --> 0
//       1,390,146: Bad Format
//       $190,235,421,127: Bad Format
//       0xFA1B: Bad Format
//       163042 --> 163042
//       -10: Overflow
//       2147483648 --> 2147483648
//       14065839182: Overflow
//       16e07: Bad Format
//       134985.0: Bad Format
//       -12034: Overflow      
Dim values() As String = { "+13230", "-0", "1,390,146", "$190,235,421,127", 
                           "0xFA1B", "163042", "-10", "2147483648",  
                           "14065839182", "16e07", "134985.0", "-12034" }
For Each value As String In values
   Try
      Dim number As UInteger = UInt32.Parse(value) 
      Console.WriteLine("{0} --> {1}", value, number)
   Catch e As FormatException
      Console.WriteLine("{0}: Bad Format", value)
   Catch e As OverflowException
      Console.WriteLine("{0}: Overflow", value)   
   End Try  
Next
' The example displays the following output:
'       +13230 --> 13230
'       -0 --> 0
'       1,390,146: Bad Format
'       $190,235,421,127: Bad Format
'       0xFA1B: Bad Format
'       163042 --> 163042
'       -10: Overflow
'       2147483648 --> 2147483648
'       14065839182: Overflow
'       16e07: Bad Format
'       134985.0: Bad Format
'       -12034: Overflow

Remarques

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

[ws][sign]digits[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 NumberFormatInfo.NegativeSign déterminés NumberFormatInfo.PositiveSign par les 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. Toutefois, le symbole de signe négatif ne peut être utilisé qu’avec zéro ; Sinon, la méthode lève une OverflowExceptionexception.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
digitsdigits Séquence de chiffres allant de 0 à 9.A sequence of digits ranging from 0 to 9. Tous les zéros non significatifs sont ignorés.Any leading zeros are ignored.

Notes

La chaîne spécifiée par le s paramètre est interprétée à l' NumberStyles.Integer aide du style.The string specified by the s parameter is interpreted by using the NumberStyles.Integer style. Il ne peut pas contenir de séparateurs de groupe ou de séparateur décimal, et il ne peut pas comporter de partie décimale.It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Le s paramètre est analysé à l’aide des informations de mise en forme System.Globalization.NumberFormatInfo d’un objet initialisé pour la culture système en cours.The s parameter is parsed by using the formatting information in a System.Globalization.NumberFormatInfo object that is initialized for the current system culture. Pour plus d'informations, consultez NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo. Pour analyser une chaîne à l’aide des informations de mise en forme d’une culture spécifique Parse(String, IFormatProvider) , utilisez la méthode.To parse a string by using the formatting information of a specific culture, use the Parse(String, IFormatProvider) method.

Voir aussi

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Int64.Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre dans un format propre à la culture spécifié en son équivalent entier non signé 32 bits.Converts the string representation of a number in a specified culture-specific format to its 32-bit unsigned integer equivalent.

public:
 static System::UInt32 Parse(System::String ^ s, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static uint Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> uint32
Public Shared Function Parse (s As String, provider As IFormatProvider) As UInteger

Paramètres

s
String String String String

Chaîne qui représente le nombre à convertir.A string that represents the number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider 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.

Retours

Entier non signé 32 bits équivalant au nombre spécifié dans s.A 32-bit unsigned integer equivalent to the number specified in s.

Exceptions

Le style de s est incorrect.s is not in the correct style.

s représente un nombre qui est inférieur à MinValue ou supérieur à MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant est le gestionnaire d’événements de clic de bouton d’un formulaire Web.The following example is the button click event handler of a Web form. Elle utilise le tableau retourné par la HttpRequest.UserLanguages propriété pour déterminer les paramètres régionaux de l’utilisateur.It uses the array returned by the HttpRequest.UserLanguages property to determine the user's locale. Il instancie ensuite un CultureInfo objet qui correspond à ces paramètres régionaux.It then instantiates a CultureInfo object that corresponds to that locale. L' NumberFormatInfo objet qui appartient à cet CultureInfo objet est ensuite transmis à la Parse(String, IFormatProvider) méthode UInt32 pour convertir l’entrée de l’utilisateur en valeur.The NumberFormatInfo object that belongs to that CultureInfo object is then passed to the Parse(String, IFormatProvider) method to convert the user's input to a UInt32 value.

protected void OkToUInteger_Click(object sender, EventArgs e)
{
   string locale;
   uint number;
   CultureInfo culture;

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return;

  // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);

   // Convert user input from a string to a number
   try
   {
      number = UInt32.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OKToUInteger_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OKToUInteger.Click
   Dim locale As String
   Dim culture As CultureInfo
   Dim number As UInteger

   ' Return if string is empty
   If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub

   ' Get locale of web request to determine possible format of number
   If Request.UserLanguages.Length = 0 Then Exit Sub
   locale = Request.UserLanguages(0)
   If String.IsNullOrEmpty(locale) Then Exit Sub

   ' Instantiate CultureInfo object for the user's locale
   culture = New CultureInfo(locale)

   ' Convert user input from a string to a number
   Try
      number = UInt32.Parse(Me.inputNumber.Text, culture.NumberFormat)
   Catch ex As FormatException
      Exit Sub
   Catch ex As Exception
      Exit Sub
   End Try

   ' Output number to label on web form
   Me.outputNumber.Text = "Number is " & number.ToString()
End Sub

Remarques

Le s paramètre contient un nombre au format suivant :The s parameter contains a number of the form:

[ws][sign]digits[ws][ws][sign]digits[ws]

Les éléments entre crochets ([et]) sont facultatifs.Items 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 Un signe facultatif ou un signe négatif si s représente la valeur zéro.An optional sign, or a negative sign if s represents the value zero.
digitsdigits Séquence de chiffres allant de 0 à 9.A sequence of digits ranging from 0 to 9.

Le paramètre s est interprété à l' NumberStyles.Integer aide du style.The s parameter is interpreted using the NumberStyles.Integer style. En plus des chiffres décimaux de la valeur entière non signée, seuls les espaces de début et de fin, ainsi qu’un signe de début, sont autorisés.In addition to the unsigned integer value's decimal digits, only leading and trailing spaces along with a leading sign is allowed. (Si le signe négatif est présent, s doit représenter une valeur égale à zéro ou la méthode lève une OverflowExceptionexception.) Pour définir explicitement les éléments de style avec les informations de mise en forme propres à la culture qui peuvent sêtre présentes dans Parse(String, NumberStyles, IFormatProvider) , utilisez la méthode.(If the negative sign is present, s must represent a value of zero, or the method throws an OverflowException.) To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Parse(String, NumberStyles, IFormatProvider) method.

Le provider paramètre est une IFormatProvider implémentation dont GetFormat la méthode retourne NumberFormatInfo un objet qui fournit des informations spécifiques à la culture sur sle format de.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Il existe trois façons d’utiliser le provider paramètre pour fournir des informations de mise en forme personnalisées à l’opération d’analyse:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Vous pouvez transmettre l’objet NumberFormatInfo réel qui fournit les informations de mise en forme.You can pass the actual NumberFormatInfo object that provides formatting information. (Son implémentation de GetFormat retourne simplement lui-même.)(Its implementation of GetFormat simply returns itself.)

  • Vous pouvez passer un CultureInfo objet qui spécifie la culture dont la mise en forme doit être utilisée.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. Sa NumberFormat propriété fournit des informations de mise en forme.Its NumberFormat property provides formatting information.

  • Vous pouvez passer une implémentation IFormatProvider personnalisée.You can pass a custom IFormatProvider implementation. Sa GetFormat méthode doit instancier et retourner NumberFormatInfo l’objet qui fournit les informations de mise en forme.Its GetFormat method must instantiate and return the NumberFormatInfo object that provides formatting information.

Si provider est null, leNumberFormatInfo pour la culture actuelle est utilisé.If provider is null, the NumberFormatInfo for the current culture is used.

Voir aussi

S’applique à