UInt32.TryParse UInt32.TryParse UInt32.TryParse UInt32.TryParse Method

Definice

Pokusí se převést řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Vrácená hodnota označuje, zda byl převod úspěšný, či nikoli.A return value indicates whether the conversion succeeded or failed.

Přetížení

TryParse(String, UInt32) TryParse(String, UInt32) TryParse(String, UInt32) TryParse(String, UInt32)

Pokusí se převést řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Vrácená hodnota označuje, zda byl převod úspěšný, či nikoli.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32)
TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32)

Pokusí se převést řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.Tries to convert the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent. Vrácená hodnota označuje, zda byl převod úspěšný, či nikoli.A return value indicates whether the conversion succeeded or failed.

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

Poznámky

Poznámka

Některé příklady jazyka C# v tomto článku spustit Try.NET runner a playground vloženého kódu.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Pokud je přítomen, vyberte spustit tlačítko spustit příklad v interaktivním okně.When present, select the Run button to run an example in an interactive window. Jakmile se při spuštění kódu, můžete upravit a spustit upravený kód tak, že vyberete spustit znovu.Once you execute the code, you can modify it and run the modified code by selecting Run again. Upravené kód je buď spuštěn v interaktivním okně, nebo pokud kompilace se nezdaří, interaktivní okno zobrazuje všechny jazyka C# kompilátoru chybové zprávy.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

TryParse(String, UInt32) TryParse(String, UInt32) TryParse(String, UInt32) TryParse(String, UInt32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

Pokusí se převést řetězcové vyjádření čísla na jeho 32 unsigned integer ekvivalent.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Vrácená hodnota označuje, zda byl převod úspěšný, či nikoli.A return value indicates whether the conversion succeeded or failed.

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

Parametry

s
String String String String

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

result
UInt32 UInt32 UInt32 UInt32

Když tato metoda vrátí hodnotu, obsahuje 32 unsigned integer hodnota, která odpovídá číslu obsaženému v s, pokud je převod úspěšný, nebo nula, pokud se převod nezdařil.When this method returns, contains the 32-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. Převod se nezdařil, s Pokud je null parametr Emptynebo, není ve správném formátu MinValue nebo představuje MaxValuečíslo, které je menší nebo rovno.The conversion fails if the s parameter is null or Empty, is not of the correct format, or represents a number that is less than MinValue or greater than MaxValue. Tento parametr se předává jako Neinicializovaný; Všechny původně zadané result hodnoty se přepíší.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Návraty

truev s případě, že byl úspěšně převeden false, v opačném případě.true if s was converted successfully; otherwise, false.

Příklady

Následující příklad volá TryParse(String, UInt32) metodu jednou pro každý prvek v poli řetězců.The following example calls the TryParse(String, UInt32) method once for each element in a string array.

string[] numericStrings = { "1293.8", "+1671.7", "28347.",  
                            "   33113684  ", "(0)", "-0", "-1", 
                            "+1293617", "18-", "119870", "31,024", 
                            "  3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
   if (UInt32.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt32.
//       Cannot convert '+1671.7' to a UInt32.
//       Cannot convert '28347.' to a UInt32.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt32.
//       Converted '-0' to 0.
//       Cannot convert '-1' to a UInt32.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt32.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt32.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", 
                                  "   33113684  ", "(0)", "-0", "-1",
                                  "+1293617", "18-", "119870", 
                                  "31,024", "  3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
   If UInt32.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt32.
'       Cannot convert '+1671.7' to a UInt32.
'       Cannot convert '28347.' to a UInt32.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt32.
'       Converted '-0' to 0.
'       Cannot convert '-1' to a UInt32.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt32.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt32.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

Poznámky

TryParse Metoda je Parse podobně jako metoda s tím rozdílem, že nevyvolá výjimku, pokud převod není úspěšný.The TryParse method is like the Parse method, except that it does not throw an exception if the conversion fails. Tato metoda eliminuje nutnost použít zpracování výjimek k otestování FormatException , pokud s je neplatný a nelze ji úspěšně analyzovat.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be successfully parsed.

s Parametr by měl být řetězcové vyjádření desítkového čísla v následujícím tvaru:The s parameter should be the string representation of a decimal 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 NumberFormatInfo.NegativeSign vlastnostmi a NumberFormatInfo.PositiveSign aktuální jazykové verze.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
znakdigits Posloupnost čísel v desítkové soustavě v rozsahu od 0 do 9.A sequence of decimal digits ranging from 0 to 9.

Parametr je interpretován NumberStyles.Integer pomocí stylu. sThe s parameter is interpreted by using the NumberStyles.Integer style. Kromě desítkových číslic jsou povoleny pouze úvodní a koncové mezery s počátečním znaménkem.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Chcete-li explicitně definovat prvky stylu s informacemi o formátování specifické jazykové verze, které mohou být spřítomny v TryParse(String, NumberStyles, IFormatProvider, UInt32) , zavolejte metodu.To explicitly define the style elements with the culture-specific formatting information that can be present in s, call the TryParse(String, NumberStyles, IFormatProvider, UInt32) method.

Poznámka

Řetězec určený s parametrem nesmí obsahovat žádné oddělovače skupin ani oddělovač desetinných míst a nemůže mít zlomkovou část.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a fractional portion.

Parametr je analyzován pomocí informací o formátování NumberFormatInfo v objektu pro aktuální jazykovou verzi systému. sThe s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. Další informace naleznete v tématu NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

Toto přetížení interpretuje všechny číslice v s parametru jako desítkové číslice.This overload interprets all digits in the s parameter as decimal digits. Chcete-li analyzovat řetězcové vyjádření šestnáctkového čísla, zavolejte TryParse(String, NumberStyles, IFormatProvider, UInt32) místo toho přetížení.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt32) overload instead.

Viz také

TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32) TryParse(ReadOnlySpan<Char>, UInt32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

Parametry

Návraty

TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32) TryParse(String, NumberStyles, IFormatProvider, UInt32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

Pokusí se převést řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho 32 unsigned integer ekvivalent.Tries to convert the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent. Vrácená hodnota označuje, zda byl převod úspěšný, či nikoli.A return value indicates whether the conversion succeeded or failed.

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

Parametry

s
String String String String

Řetězec, který představuje číslo k převedení.A string that represents the number to convert. Řetězec je interpretován pomocí stylu určeného style parametrem.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

result
UInt32 UInt32 UInt32 UInt32

Když tato metoda vrátí, obsahuje 32 unsigned integer hodnota ekvivalentní číslu obsaženému v s, pokud je převod úspěšný, nebo nula, pokud se převod nezdařil.When this method returns, contains the 32-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. Převod se nezdařil, s Pokud je null parametr Emptynebo, není ve formátu, který je stylekompatibilní s, MaxValuenebo představuje číslo, které je MinValue menší nebo rovno.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number that is less than MinValue or greater than MaxValue. Tento parametr se předává jako Neinicializovaný; Všechny původně zadané result hodnoty se přepíší.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Návraty

truev s případě, že byl úspěšně převeden false, v opačném případě.true if s was converted successfully; otherwise, false.

Výjimky

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

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

Příklady

Následující příklad volá TryParse(String, NumberStyles, IFormatProvider, UInt32) metodu s řadou různých řetězců a NumberStyles hodnot.The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt32) method with a number of different strings and NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "2106034";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103674.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "41792210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC86DA1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      uint number;
      bool result = UInt32.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output:
//       Converted '2106034' to 2106034.
//       Attempted conversion of '-10603' failed.
//       Converted '29103674.00' to 29103674.
//       Attempted conversion of '10345.72' failed.
//       Converted '41792210E-01' to 4179221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC86DA1' to 4291325345.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "2106034"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103674.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "41792210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC86DA1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UInteger
      Dim result As Boolean = UInt32.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '2106034' to 2106034.
'       Attempted conversion of '-10603' failed.
'       Converted '29103674.00' to 29103674.
'       Attempted conversion of '10345.72' failed.
'       Converted '41792210E-01' to 4179221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC86DA1' to 4291325345.
'       Attempted conversion of '0x8F8C' failed.

Poznámky

TryParse(String, NumberStyles, IFormatProvider, UInt32) Metoda je Parse(String, NumberStyles, IFormatProvider) podobně jako metoda s tím rozdílem, že nevyvolá výjimku, pokud převod není úspěšný.The TryParse(String, NumberStyles, IFormatProvider, UInt32) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. Tato metoda eliminuje nutnost použít zpracování výjimek k otestování FormatException , pokud s je neplatný a nelze ji úspěšně analyzovat.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

Parametr definuje prvky stylu (například prázdné znaky nebo kladné nebo záporné znaménko), které jsou povoleny s v parametru pro úspěšné provedení operace analýzy. styleThe style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the s parameter for the parse operation to succeed. Musí být kombinací bitových příznaků od NumberStyles výčtu.It must be a combination of bit flags from the NumberStyles enumeration. V závislosti na hodnotě style s může parametr 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]

Položky v hranatých závorkách ([ a ]) jsou volitelné.Items in square brackets ([ and ]) are optional. Nebo, pokud style parametr obsahuje NumberStyles.AllowHexSpecifier, s parametr může obsahovat následující prvky:Or, if the style parameter 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. Prázdné znaky mohou být zobrazeny na začátku s , pokud style obsahuje NumberStyles.AllowLeadingWhite příznak NumberStyles.AllowTrailingWhite nebo na konci s , pokud style obsahuje příznak.White space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, or 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 CurrencyPositivePattern definována vlastností NumberFormatInfo objektu vráceného GetFormat metodou provider parametru.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Symbol měny se může objevit v s části style if obsahuje NumberStyles.AllowCurrencySymbol příznak.The 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 s na začátku, pokud style obsahuje NumberStyles.AllowLeadingSign příznak s a může NumberStyles.AllowTrailingSign se objevit na konci, pokud style obsahuje příznak.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 NumberStyles.AllowParentheses příznak.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Nicméně, pokud je k dispozici záporné znaménko, s může představovat hodnotu nula pouze pro úspěšné provedení operace analýzy.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.
znakdigits Řada číslic od 0 do 9.A sequence of digits from 0 through 9.
,, Oddělovač skupin specifický pro jazykovou verzi.A culture-specific group separator. V provider případěs ,žeNumberStyles.AllowThousands obsahuje příznak, se může objevit oddělovač skupiny jazykové verze určené parametrem. styleThe group separator of the culture specified by provider 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 jazykové verze určený parametrem provider se může objevit s v style části NumberStyles.AllowDecimalPoint if obsahuje příznak.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Jeden nebo více výskytů číslice 0.One or more occurrences of the digit 0. Zlomkové číslice se mohou objevit s pouze v style případě, NumberStyles.AllowDecimalPoint že obsahuje příznak.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 může představovat číslo v exponenciálním zápisu, pokud style obsahuje NumberStyles.AllowExponent příznak. sThe 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 může představovat číslo v exponenciálním zápisu, pokud style obsahuje NumberStyles.AllowExponent příznak. sThe 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) v s jsou ignorovány operací analýzy bez ohledu na hodnotu style argumentu.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á NumberStyles.None příznaku) se vždy analyzuje úspěšně.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Většina zbývajících NumberStyles členů určuje ovládací prvky, které mohou být přítomny, ale v tomto vstupním řetězci nejsou nutné.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é NumberStyles členy ovlivňují prvky, které mohou být přítomny sv.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Hodnoty, které NumberStyles nejsou složenéNon-composite NumberStyles values Prvky, které jsou povoleny v hodnotě kromě číslicElements permitted in value in addition to digits
None Pouze desítkové číslice.Decimal digits only.
AllowDecimalPoint Prvky desetinné čárky (.) a fractional_digits .The decimal point (.) and fractional_digits elements. Fractional_digits však musí obsahovat pouze jednu nebo více číslic 0 nebo metoda vrátí hodnotu false.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
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. Pokud s představuje číslo v exponenciální notaci, nemůže mít nenulovou, zlomkovou komponentu.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
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 před číslicemi.The sign element before digits.
AllowTrailingSign Element Sign za číslicemi.The sign element after digits.
AllowParentheses Element Sign ve formě závorek, který obklopuje nulovou číselnou hodnotu.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Prvek oddělovače skupin (,).The group separator (,) element.
AllowCurrencySymbol Element Currency ($).The currency ($) element.
Currency Všechny prvky.All elements. V exponenciálním zápisu ale nemůžepředstavovatšestnáctkovéčísloaničíslo.sHowever, s cannot represent a hexadecimal number or a number in exponential notation.
Float Element WS na začátku nebo konci s s, podepsat na začátku a symbol desetinné čárky (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. s Parametr 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 Nemůže ale představovat hexadecimální číslo.However, s cannot represent a hexadecimal number.

Pokud se použije spříznak, musí být hexadecimální hodnota. NumberStyles.AllowHexSpecifierIf the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Jediné další příznaky, které mohou být přítomny style v NumberStyles.AllowLeadingWhite nástroji NumberStyles.AllowTrailingWhite, jsou a.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Výčet má složený styl, HexNumber, který obsahuje příznaky bílého místa.) NumberStyles(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Poznámka

Pokud s je řetězcové vyjádření šestnáctkového čísla, nemůže mu předcházet žádná dekorace ( 0x například 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.

provider ParametrIFormatProvider je implementace.The provider parameter is an IFormatProvider implementation. Jeho GetFormat metoda svrátí objekt, který poskytuje informace specifické jazykové verze o formátu. NumberFormatInfoIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. provider Parametr může mít jednu z následujících možností:The provider parameter can be any one of the following:

  • CultureInfo Objekt, který představuje jazykovou verzi poskytující informace o formátování.A CultureInfo object that represents the culture that supplies formatting information. Jeho GetFormat MetodaNumberFormatInfo vrátí objekt, který poskytuje informace o formátování čísel pro tuto jazykovou verzi.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • NumberFormatInfo Objekt, který poskytuje informace o formátování čísel.A NumberFormatInfo object that provides numeric formatting information. (Implementace GetFormat jenom vrátí sám sebe.)(Its implementation of GetFormat just returns itself.)

  • Vlastní objekt, který implementuje IFormatProvider.A custom object that implements IFormatProvider. Jeho GetFormat metoda vytvoří instanci a NumberFormatInfo vrátí objekt, který poskytuje informace o formátování.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

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

Viz také

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

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

Parametry

Návraty

Platí pro