UInt32.Parse Metoda

Definice

Převede řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.Converts the string representation of a number to its 32-bit unsigned integer equivalent.

Přetížení

Parse(String, NumberStyles, IFormatProvider)

Převede řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.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)

Převede reprezentaci čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.Converts the span representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent.

Parse(String, NumberStyles)

Převede řetězcové vyjádření čísla v zadaném stylu na jeho 32 unsigned integer ekvivalent.Converts the string representation of a number in a specified style to its 32-bit unsigned integer equivalent.

Parse(String)

Převede řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.Converts the string representation of a number to its 32-bit unsigned integer equivalent.

Parse(String, IFormatProvider)

Převede řetězcové vyjádření čísla v zadaném formátu specifickém pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.Converts the string representation of a number in a specified culture-specific format to its 32-bit unsigned integer equivalent.

Parse(String, NumberStyles, IFormatProvider)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS
System.Int64.Parse(String)

Převede řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.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

Parametry

s
String

Řetězec představující číslo, které má být převedeno.A string representing the number to convert. Řetězec je interpretován pomocí stylu určeného parametrem style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles

Bitová kombinace hodnot výčtu, která určuje prvky stylu, které mohou být přítomny v s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Typická hodnota, která se má zadat, je Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi o s.An object that supplies culture-specific formatting information about s.

Návraty

32 unsigned integer ekvivalent k číslu zadanému v s.A 32-bit unsigned integer equivalent to the number specified in s.

Atributy

Výjimky

s je null.s is null.

style není NumberStyles hodnota.style is not a NumberStyles value.

-nebo--or- style není kombinací hodnot AllowHexSpecifier a HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

s není ve formátu, který je kompatibilní s style.s is not in a format compliant with style.

s představuje číslo, které je menší než MinValue nebo větší než MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

-nebo--or- s obsahuje nenulové a zlomkové číslice.s includes non-zero, fractional digits.

Příklady

Následující příklad používá metodu Parse(String, NumberStyles, IFormatProvider) pro převod různých řetězcových reprezentace čísel na 32 hodnoty unsigned integer.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.

Poznámky

Parametr style definuje prvky stylu (například mezeru nebo symbol kladné nebo záporné znaménko), které jsou povoleny v parametru s pro úspěšné provedení operace analýzy.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. Musí se jednat o kombinaci bitových příznaků z výčtu NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration.

V závislosti na hodnotě style``s parametr může obsahovat následující prvky:Depending on the value of style, the s parameter may include the following elements:

[ws][$][sign]digits[.fractional_digits][E[sign]exponential_digits][ws][ws][$][sign]digits[.fractional_digits][E[sign]exponential_digits][ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Pokud style zahrnuje NumberStyles.AllowHexSpecifier, s parametr může obsahovat následující prvky:If style includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space. Na začátku s se může zobrazit prázdný znak, pokud style obsahuje příznak NumberStyles.AllowLeadingWhite a může se objevit na konci s Pokud style obsahuje příznak NumberStyles.AllowTrailingWhite.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.
$ Symbol měny pro konkrétní jazykovou verzi.A culture-specific currency symbol. Jeho pozice v řetězci je definována vlastností CurrencyPositivePattern objektu NumberFormatInfo, který je vrácen metodou GetFormat parametru provider.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. Symbol měny se může zobrazit v s, pokud style obsahuje příznak NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Nepovinný znak.An optional sign. (Metoda vyvolá OverflowException, pokud s obsahuje záporné znaménko a představuje nenulové číslo.) Znaménko se může zobrazit na začátku s, pokud style obsahuje příznak NumberStyles.AllowLeadingSign a může se zobrazit na konci s, pokud style obsahuje příznak NumberStyles.AllowTrailingSign.(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. Závorky lze použít v s k označení záporné hodnoty, pokud style obsahuje příznak NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
znakdigits Řada číslic od 0 do 9.A sequence of digits from 0 through 9.
.. Symbol desetinné čárky specifický pro jazykovou verzi.A culture-specific decimal point symbol. Symbol desetinné čárky aktuální jazykové verze se může objevit v s, pokud style obsahuje příznak NumberStyles.AllowDecimalPoint.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Jeden nebo více výskytů číslice 0-9, pokud style obsahuje příznak NumberStyles.AllowExponent nebo jeden nebo více výskytů číslice 0, pokud tomu tak není.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. Zlomkové číslice se mohou v s zobrazit pouze v případě, že style obsahuje příznak NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
EE Znak "e" nebo "E", který určuje, že hodnota je reprezentován v exponenciální (vědecké) notaci.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Parametr s může představovat číslo v exponenciální notaci, pokud style obsahuje příznak NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits Řada číslic od 0 do 9.A sequence of digits from 0 through 9. Parametr s může představovat číslo v exponenciální notaci, pokud style obsahuje příznak NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Posloupnost šestnáctkových číslic od 0 do f nebo id 0 do F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Poznámka

Všechny ukončující znaky NUL (U + 0000) ve s jsou ignorovány operací analýzy bez ohledu na hodnotu argumentu style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Řetězec s pouze desítkovými číslicemi (který odpovídá stylu NumberStyles.None) se vždy analyzuje úspěšně.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. Většina zbývajících NumberStyles prvků ovládacího prvku, které mohou být k dispozici, ale v tomto vstupním řetězci nejsou přítomny.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. Následující tabulka uvádí, jak jednotlivé členy NumberStyles ovlivňují prvky, které mohou být přítomny v s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Nesložené NumberStyles hodnotyNon-composite NumberStyles values Prvky povolené v s Kromě číslicElements permitted in s in addition to digits
NumberStyles.None Pouze desítkové číslice.Decimal digits only.
NumberStyles.AllowDecimalPoint Prvky desetinné čárky (.) a fractional_digits .The decimal point (.) and fractional_digits elements. Pokud však Style neobsahuje příznak NumberStyles.AllowExponent, fractional_digits musí obsahovat pouze jednu nebo více číslic 0; v opačném případě je vyvolána OverflowException.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 Znak "e" nebo "E", který označuje exponenciální zápis, spolu s exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite Element WS na začátku s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Element WS na konci s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Znaménko před číslicemi.A sign before digits.
NumberStyles.AllowTrailingSign Znaménko za číslicemiA sign after digits.
NumberStyles.AllowParentheses Závorky před a za číslicemi , které označují zápornou hodnotu.Parentheses before and after digits to indicate a negative value.
NumberStyles.AllowThousands Prvek oddělovače skupin (,).The group separator (,) element.
NumberStyles.AllowCurrencySymbol Element Currency ($).The currency ($) element.

Pokud se používá příznak NumberStyles.AllowHexSpecifier, s musí být hexadecimální hodnota.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Jediným jiným příznakem, který lze v kombinaci s ním kombinovat, je NumberStyles.AllowLeadingWhite a NumberStyles.AllowTrailingWhite.The only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (NumberStyles výčet obsahuje složený styl čísla, NumberStyles.HexNumber, který obsahuje příznaky bílého místa.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Poznámka

Pokud je parametr s řetězcové vyjádření šestnáctkového čísla, nemůže mu předcházet žádná dekorace (například 0x nebo &h), která ho odlišuje jako šestnáctkové číslo.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. To způsobí, že operace analýzy vyvolá výjimku.This causes the parse operation to throw an exception.

Parametr provider je IFormatProvider implementace, jejíž metoda GetFormat vrací objekt NumberFormatInfo, který poskytuje informace specifické jazykové verze o formátu s.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Existují tři způsoby, jak použít parametr provider k poskytnutí informací o vlastním formátování do operace analýzy:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Můžete předat skutečný objekt NumberFormatInfo, který poskytuje informace o formátování.You can pass the actual NumberFormatInfo object that provides formatting information. (Jeho implementace GetFormat jednoduše vrátí sám sebe.)(Its implementation of GetFormat simply returns itself.)

  • Můžete předat objekt CultureInfo, který určuje jazykovou verzi, jejíž formátování má být použito.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. Jeho vlastnost NumberFormat poskytuje informace o formátování.Its NumberFormat property provides formatting information.

  • Můžete předat vlastní implementaci IFormatProvider.You can pass a custom IFormatProvider implementation. Její GetFormat metoda musí vytvářet instance a vracet NumberFormatInfo objekt, který poskytuje informace o formátování.Its GetFormat method must instantiate and return the NumberFormatInfo object that provides formatting information.

Je-li provider null, je použit objekt NumberFormatInfo pro aktuální jazykovou verzi.If provider is null, the NumberFormatInfo object for the current culture is used.

Viz také

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Převede reprezentaci čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.Converts the span representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent.

[System.CLSCompliant(false)]
public static uint Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);
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

Parametry

s
ReadOnlySpan<Char>

Rozpětí obsahující znaky, které mají být převedeny.A span containing the characters that represent the number to convert. Rozsah je interpretován pomocí stylu určeného parametrem style.The span is interpreted by using the style specified by the style parameter.

style
NumberStyles

Bitová kombinace hodnot výčtu, která určuje prvky stylu, které mohou být přítomny v s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Typická hodnota, která se má zadat, je Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi o s.An object that supplies culture-specific formatting information about s.

Návraty

32 unsigned integer ekvivalent k číslu zadanému v s.A 32-bit unsigned integer equivalent to the number specified in s.

Atributy

Parse(String, NumberStyles)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS
System.Int64.Parse(String)

Převede řetězcové vyjádření čísla v zadaném stylu na jeho 32 unsigned integer ekvivalent.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

Parametry

s
String

Řetězec představující číslo, které má být převedeno.A string representing the number to convert. Řetězec je interpretován pomocí stylu určeného parametrem style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles

Bitová kombinace hodnot výčtu, které určují povolený formát s.A bitwise combination of the enumeration values that specify the permitted format of s. Typická hodnota, která se má zadat, je Integer.A typical value to specify is Integer.

Návraty

32 unsigned integer ekvivalent k číslu zadanému v s.A 32-bit unsigned integer equivalent to the number specified in s.

Atributy

Výjimky

s je null.s is null.

style není NumberStyles hodnota.style is not a NumberStyles value.

-nebo--or- style není kombinací hodnot AllowHexSpecifier a HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

s není ve formátu, který je kompatibilní s style.s is not in a format compliant with style.

s představuje číslo, které je menší než MinValue nebo větší než MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

-nebo--or- s obsahuje nenulové a zlomkové číslice.s includes non-zero, fractional digits.

Příklady

Následující příklad se pokusí analyzovat každý prvek v poli řetězců pomocí řady hodnot NumberStyles.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

Poznámky

Parametr style definuje prvky stylu (například prázdné znaky, symbol kladného nebo záporného znaménka, symbol oddělovače skupiny nebo symbol desetinné čárky), které jsou povoleny v parametru s pro úspěšné provedení operace analýzy.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. style musí být kombinací bitových příznaků od NumberStyles výčtu.style must be a combination of bit flags from the NumberStyles enumeration. Parametr style umožňuje přetížení této metody, když s obsahuje řetězcové vyjádření hexadecimální hodnoty, když číselný systém (desítkové nebo šestnáctkové) reprezentovaný s je známý pouze v době běhu, nebo pokud chcete zakázat prázdné znaky nebo symbol znaménka v s.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.

V závislosti na hodnotě style``s parametr může obsahovat následující prvky:Depending on the value of style, the s 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]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Pokud style zahrnuje NumberStyles.AllowHexSpecifier, parametr s může obsahovat následující prvky:If style includes NumberStyles.AllowHexSpecifier, the s parameter may contain the following elements:

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

Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space. Prázdné znaky se mohou objevit na začátku s, pokud style obsahuje příznak NumberStyles.AllowLeadingWhite a může se objevit na konci s Pokud style obsahuje příznak NumberStyles.AllowTrailingWhite.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.
$ Symbol měny pro konkrétní jazykovou verzi.A culture-specific currency symbol. Jeho pozice v řetězci je definována NumberFormatInfo.CurrencyNegativePattern a NumberFormatInfo.CurrencyPositivePattern vlastností aktuální jazykové verze.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. Symbol měny aktuální jazykové verze se může objevit v s, pokud style obsahuje příznak NumberStyles.AllowCurrencySymbol.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Nepovinný znak.An optional sign. Znaménko se může zobrazit na začátku s, pokud style obsahuje příznak NumberStyles.AllowLeadingSign a může se objevit na konci s Pokud style obsahuje příznak NumberStyles.AllowTrailingSign.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. Závorky lze použít v s k označení záporné hodnoty, pokud style obsahuje příznak NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Symbol záporného znaménka se však dá použít jenom s nulou; v opačném případě metoda vyvolá OverflowException.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
znakdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Řada číslic od 0 do 9.A sequence of digits from 0 through 9. Pro fractional_digitsje platná pouze číslice 0.For fractional_digits, only the digit 0 is valid.
,, Symbol oddělovače skupin, specifický pro jazykovou verzi.A culture-specific group separator symbol. Oddělovač skupin aktuální jazykové verze se může objevit v s, pokud style obsahuje příznak NumberStyles.AllowThousands.The current culture's group separator can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Symbol desetinné čárky specifický pro jazykovou verzi.A culture-specific decimal point symbol. Symbol desetinné čárky aktuální jazykové verze se může objevit v s, pokud style obsahuje příznak NumberStyles.AllowDecimalPoint.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag. Pouze číslice 0 se může zobrazit jako zlomková číslice pro úspěšné provedení operace analýzy; Pokud fractional_digits zahrnuje jakékoli jiné číslice, je vyvolána FormatException.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 Znak "e" nebo "E", který určuje, že hodnota je reprezentován v exponenciální (vědecké) notaci.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Parametr s může představovat číslo v exponenciální notaci, pokud style obsahuje příznak NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Posloupnost šestnáctkových číslic od 0 do f nebo id 0 do F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Poznámka

Všechny ukončující znaky NUL (U + 0000) ve s jsou ignorovány operací analýzy bez ohledu na hodnotu argumentu style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Řetězec s pouze číslicemi (který odpovídá stylu NumberStyles.None) vždy analyzuje úspěšně, pokud je v rozsahu UInt32 typu.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully if it is in the range of the UInt32 type. Většina zbývajících NumberStyles prvků ovládacího prvku, které mohou být k dispozici, ale ve vstupním řetězci není nutné je prezentovat.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in the input string. Následující tabulka uvádí, jak jednotlivé členy NumberStyles ovlivňují prvky, které mohou být přítomny v s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

hodnota NumberStylesNumberStyles value Prvky povolené v s Kromě číslicElements permitted in s in addition to digits
None Pouze element číslice .The digits element only.
AllowDecimalPoint Prvky desetinné čárky (.) a zlomkové číslice .The decimal point (.) and fractional-digits elements.
AllowExponent Znak "e" nebo "E", který označuje exponenciální zápis, spolu s exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
AllowLeadingWhite Element WS na začátku s.The ws element at the start of s.
AllowTrailingWhite Element WS na konci s.The ws element at the end of s.
AllowLeadingSign Element Sign na začátku s.The sign element at the start of s.
AllowTrailingSign Element Sign na konci s.The sign element at the end of s.
AllowParentheses Element Sign ve formě závorek, který obklopuje číselnou hodnotu.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands Prvek oddělovače skupin (,).The group separator (,) element.
AllowCurrencySymbol Prvek měny ($).The currency ($) element.
Currency Všechny prvky.All elements. s ale nemůže představovat šestnáctkové číslo ani číslo v exponenciální notaci.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Element WS na začátku nebo konci s, podepsat na začátku sa symbol desetinné čárky (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Parametr s může také používat exponenciální zápis.The s parameter can also use exponential notation.
Number Prvky ws, sign, oddělovač skupin (,) a desetinná čárka (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Všechny prvky.All elements. s ale nemůže představovat šestnáctkové číslo.However, s cannot represent a hexadecimal number.

Na rozdíl od ostatních hodnot NumberStyles, které umožňují, ale nevyžadují, přítomnost konkrétních prvků stylu v s, hodnota NumberStyles.AllowHexSpecifier stylu znamená, že jednotlivé číselné znaky v s jsou vždy interpretovány jako šestnáctkové znaky.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. Platné šestnáctkové znaky jsou 0-9, A-F a a-f.Valid hexadecimal characters are 0-9, A-F, and a-f. Předpona, například 0x, není povolena.A prefix, such as "0x", is not allowed. Jedinými ostatními příznaky, které lze kombinovat s parametrem style, jsou NumberStyles.AllowLeadingWhite a NumberStyles.AllowTrailingWhite.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (NumberStyles výčet obsahuje složený styl čísla, NumberStyles.HexNumber, který obsahuje příznaky bílého místa.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Jedinými ostatními příznaky, které lze kombinovat s parametrem style, jsou NumberStyles.AllowLeadingWhite a NumberStyles.AllowTrailingWhite.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (NumberStyles výčet obsahuje složený styl čísla, NumberStyles.HexNumber, který obsahuje příznaky bílého místa.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

Poznámka

Pokud je s řetězcové vyjádření šestnáctkového čísla, nemůže mu předcházet žádná dekorace (například 0x nebo &h), která ho odlišuje jako šestnáctkové číslo.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. To způsobí selhání převodu.This causes the conversion to fail.

Parametr s je analyzován pomocí informací o formátování v objektu NumberFormatInfo, který je inicializován pro aktuální jazykovou verzi systému.The s parameter is parsed by using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Chcete-li určit jazykovou verzi, jejíž informace o formátování jsou použity pro operaci analýzy, zavolejte Parse(String, NumberStyles, IFormatProvider) přetížení.To specify the culture whose formatting information is used for the parse operation, call the Parse(String, NumberStyles, IFormatProvider) overload.

Viz také

Parse(String)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS
System.Int64.Parse(String)

Převede řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.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

Parametry

s
String

Řetězec představující číslo, které má být převedeno.A string representing the number to convert.

Návraty

32 unsigned integer ekvivalent k číslu obsaženému v s.A 32-bit unsigned integer equivalent to the number contained in s.

Atributy

Výjimky

Parametr s má hodnotu null.The s parameter is null.

Parametr s nemá správný formát.The s parameter is not of the correct format.

Parametr s představuje číslo, které je menší než MinValue nebo větší než MaxValue.The s parameter represents a number that is less than MinValue or greater than MaxValue.

Příklady

Následující příklad používá metodu Parse(String) k analýze pole řetězcových hodnot.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

Poznámky

Parametr s musí být řetězcové vyjádření čísla v následujícím formuláři.The s parameter should be the string representation of a number in the following form.

[WS] [Sign] číslice[WS][ws][sign]digits[ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space.
signsign Nepovinný znak.An optional sign. Platné znaky znaménka jsou určeny vlastnostmi NumberFormatInfo.NegativeSign a NumberFormatInfo.PositiveSign aktuální jazykové verze.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture. Symbol záporného znaménka se však dá použít jenom s nulou; v opačném případě metoda vyvolá OverflowException.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
znakdigits Řada číslic od 0 do 9.A sequence of digits ranging from 0 to 9. Budou ignorovány všechny úvodní nuly.Any leading zeros are ignored.

Poznámka

Řetězec určený parametrem s je interpretován pomocí stylu NumberStyles.Integer.The string specified by the s parameter is interpreted by using the NumberStyles.Integer style. Nemůže obsahovat žádné oddělovače skupin ani oddělovač desetinných míst a nemůže mít desetinnou část.It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Parametr s je analyzován pomocí informací o formátování v objektu System.Globalization.NumberFormatInfo, který je inicializován pro aktuální jazykovou verzi systému.The s parameter is parsed by using the formatting information in a System.Globalization.NumberFormatInfo object that is initialized for the current system culture. Další informace najdete v tématu NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo. Chcete-li analyzovat řetězec pomocí informací o formátování konkrétní jazykové verze, použijte metodu Parse(String, IFormatProvider).To parse a string by using the formatting information of a specific culture, use the Parse(String, IFormatProvider) method.

Viz také

Parse(String, IFormatProvider)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS
System.Int64.Parse(String)

Převede řetězcové vyjádření čísla v zadaném formátu specifickém pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.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

Parametry

s
String

Řetězec, který představuje číslo k převedení.A string that represents the number to convert.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi o s.An object that supplies culture-specific formatting information about s.

Návraty

32 unsigned integer ekvivalent k číslu zadanému v s.A 32-bit unsigned integer equivalent to the number specified in s.

Atributy

Výjimky

s je null.s is null.

s nemá správný styl.s is not in the correct style.

s představuje číslo, které je menší než MinValue nebo větší než MaxValue.s represents a number that is less than MinValue or greater than MaxValue.

Příklady

V následujícím příkladu je obslužná rutina události kliknutí na tlačítko webového formuláře.The following example is the button click event handler of a Web form. Používá pole vrácené vlastností HttpRequest.UserLanguages k určení národního prostředí uživatele.It uses the array returned by the HttpRequest.UserLanguages property to determine the user's locale. Potom vytvoří instanci objektu CultureInfo, který odpovídá danému národnímu prostředí.It then instantiates a CultureInfo object that corresponds to that locale. Objekt NumberFormatInfo, který patří k tomuto objektu CultureInfo, je následně předán metodě Parse(String, IFormatProvider) k převedení vstupu uživatele na UInt32 hodnotu.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

Poznámky

Parametr s obsahuje číslo formuláře:The s parameter contains a number of the form:

[WS] [Sign] číslice[WS][ws][sign]digits[ws]

Položky v hranatých závorkách ([ a ]) jsou volitelné.Items in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space.
signsign Volitelné znaménko nebo záporné znaménko, pokud s představuje hodnotu nula.An optional sign, or a negative sign if s represents the value zero.
znakdigits Řada číslic od 0 do 9.A sequence of digits ranging from 0 to 9.

Parametr s je interpretován pomocí stylu NumberStyles.Integer.The s parameter is interpreted using the NumberStyles.Integer style. Kromě desetinných číslic unsigned integer hodnoty jsou povoleny pouze úvodní a koncové mezery spolu s počátečním znaménkem.In addition to the unsigned integer value's decimal digits, only leading and trailing spaces along with a leading sign is allowed. (Pokud je k dispozici záporné znaménko, s musí představovat hodnotu nula, nebo metoda vyvolá OverflowException.) Chcete-li explicitně definovat prvky stylu společně s informacemi o formátování specifické jazykové verze, které mohou být k dispozici v s, použijte metodu Parse(String, NumberStyles, IFormatProvider).(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.

Parametr provider je IFormatProvider implementace, jejíž metoda GetFormat vrací objekt NumberFormatInfo, který poskytuje informace specifické jazykové verze o formátu s.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Existují tři způsoby, jak použít parametr provider k poskytnutí informací o vlastním formátování do operace analýzy:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Můžete předat skutečný objekt NumberFormatInfo, který poskytuje informace o formátování.You can pass the actual NumberFormatInfo object that provides formatting information. (Jeho implementace GetFormat jednoduše vrátí sám sebe.)(Its implementation of GetFormat simply returns itself.)

  • Můžete předat objekt CultureInfo, který určuje jazykovou verzi, jejíž formátování má být použito.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. Jeho vlastnost NumberFormat poskytuje informace o formátování.Its NumberFormat property provides formatting information.

  • Můžete předat vlastní implementaci IFormatProvider.You can pass a custom IFormatProvider implementation. Její GetFormat metoda musí vytvářet instance a vracet NumberFormatInfo objekt, který poskytuje informace o formátování.Its GetFormat method must instantiate and return the NumberFormatInfo object that provides formatting information.

Je-li provider null, je použita NumberFormatInfo pro aktuální jazykovou verzi.If provider is null, the NumberFormatInfo for the current culture is used.

Viz také

Platí pro