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

Definição

Tenta converter a representação de cadeia de caracteres de um número no inteiro sem sinal de 32 bits equivalente.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.A return value indicates whether the conversion succeeded or failed.

Sobrecargas

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

Tenta converter a representação de cadeia de caracteres de um número no inteiro sem sinal de 32 bits equivalente.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.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)

Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato de cultura especificados em seu equivalente de inteiro sem sinal de 32 bits.Tries to convert the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.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)

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

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS
System.Int64.TryParse(String, Int64)

Tenta converter a representação de cadeia de caracteres de um número no inteiro sem sinal de 32 bits equivalente.Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.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 *  -> bool
Public Shared Function TryParse (s As String, ByRef result As UInteger) As Boolean

Parâmetros

s
String String String String

Uma cadeia de caracteres que representa o número a ser convertido.A string that represents the number to convert.

result
UInt32 UInt32 UInt32 UInt32

Quando esse método for retornado, ele conterá o valor inteiro sem sinal de 32 bits equivalente ao número contido em s, se a conversão tiver sido bem-sucedida, ou zero, se a conversão tiver falhado.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. A conversão falhará se o parâmetro s for null ou Empty, não estiver no formato correto ou representar um número menor que MinValue ou maior que MaxValue.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. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result será substituído.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retornos

true caso s tenha sido convertido com êxito; do contrário, false.true if s was converted successfully; otherwise, false.

Exemplos

O exemplo a seguir chama TryParse(String, UInt32) o método uma vez para cada elemento em uma matriz de cadeia de caracteres.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.

Comentários

O TryParse método é como o Parse método, exceto pelo fato de que ele não lança uma exceção se a conversão falhar.The TryParse method is like the Parse method, except that it does not throw an exception if the conversion fails. Esse método elimina a necessidade de usar o tratamento de exceções para testar FormatException um s se é inválido e não pode ser analisado com êxito.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be successfully parsed.

O parâmetro s deve ser a representação da cadeia de caracteres de um número decimal na seguinte forma:The s parameter should be the string representation of a decimal number in the following form:

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

Os elementos entre colchetes ([ e ]) são opcionais.Elements in square brackets ([ and ]) are optional. A tabela a seguir descreve cada elemento.The following table describes each element.

ElementoElement DescriçãoDescription
wsws Espaço em branco opcional.Optional white space.
signsign Um sinal opcional.An optional sign. Os caracteres de sinal válido são determinados pelas propriedades NumberFormatInfo.NegativeSign e NumberFormatInfo.PositiveSign da cultura atual.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
digitsdigits Uma sequência de dígitos decimais que varia de 0 a 9.A sequence of decimal digits ranging from 0 to 9.

O parâmetro s é interpretado usando-se o estilo NumberStyles.Integer.The s parameter is interpreted by using the NumberStyles.Integer style. Além dos dígitos decimais, apenas os espaço à esquerda e à direita com um sinal à esquerda são permitidos.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Para definir explicitamente os elementos de estilo com as informações de formatação específicas de cultura que podem estar spresentes no, TryParse(String, NumberStyles, IFormatProvider, UInt32) chame o método.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.

Observação

A cadeia de caracteres especificada s pelo parâmetro não pode conter nenhum separador de grupo ou separador decimal e não pode ter uma parte fracionária.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a fractional portion.

O s parâmetro é analisado usando as informações de formatação em um NumberFormatInfo objeto para a cultura do sistema atual.The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. Para obter mais informações, consulte NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

Essa sobrecarga interpreta todos os dígitos no s parâmetro como dígitos decimais.This overload interprets all digits in the s parameter as decimal digits. Para analisar a representação de cadeia de caracteres de um número hexadecimal TryParse(String, NumberStyles, IFormatProvider, UInt32) , chame a sobrecarga em vez disso.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt32) overload instead.

Veja também

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

Importante

Esta API não está em conformidade com 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> *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UInteger) As Boolean

Parâmetros

Retornos

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

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS
System.Int64.TryParse(String, Int64)

Tenta converter a representação de cadeia de caracteres de um número em um estilo e formato de cultura especificados em seu equivalente de inteiro sem sinal de 32 bits.Tries to convert the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.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 *  -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) As Boolean

Parâmetros

s
String String String String

Uma cadeia de caracteres que representa o número a ser convertido.A string that represents the number to convert. A cadeia de caracteres é interpretada usando-se o estilo especificado pelo parâmetro style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Um combinação bit a bit de valores de enumeração que indica o formato permitido de s.A bitwise combination of enumeration values that indicates the permitted format of s. Um valor típico a ser especificado é Integer.A typical value to specify is Integer.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura sobre s.An object that supplies culture-specific formatting information about s.

result
UInt32 UInt32 UInt32 UInt32

Quando esse método retornar, conterá o equivalente do valor inteiro sem sinal de 32 bits do número contido em s, se a conversão tiver sido bem-sucedida, ou zero, se a conversão tiver falhado.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. A conversão falhará se o parâmetro s for null ou Empty, não estiver em um formato em conformidade com style ou representar um número menor que MinValue ou maior que MaxValue.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. Este parâmetro é passado não inicializado; qualquer valor fornecido originalmente em result será substituído.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Retornos

true caso s tenha sido convertido com êxito; do contrário, false.true if s was converted successfully; otherwise, false.

Exceções

style não é um valor NumberStyles.style is not a NumberStyles value.

- ou --or- style não é uma combinação de valores AllowHexSpecifier e HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Exemplos

O exemplo a seguir chama TryParse(String, NumberStyles, IFormatProvider, UInt32) o método com um número de cadeias NumberStyles de caracteres e valores diferentes.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.

Comentários

O TryParse(String, NumberStyles, IFormatProvider, UInt32) método é como o Parse(String, NumberStyles, IFormatProvider) método, exceto pelo fato de que ele não lança uma exceção se a conversão falhar.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. Esse método elimina a necessidade de usar o tratamento de exceções para testar FormatException um s se for inválido e não puder ser analisado com êxito.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

O parâmetro style define os elementos de estilo (como o espaço em branco ou um sinal positivo ou negativo) que são permitidos no parâmetro s para que a operação de análise seja bem-sucedida.The 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. Ele deve ser uma combinação de sinalizadores de bits da enumeração NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. Dependendo do valor de style, o parâmetro s pode incluir os seguintes elementos:Depending on the value of style, the s parameter may include the following elements:

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

Itens entre colchetes ([ e ]) são opcionais.Items in square brackets ([ and ]) are optional. Ou, se o style parâmetro incluir NumberStyles.AllowHexSpecifier, o s parâmetro poderá incluir os seguintes elementos:Or, if the style parameter includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

A tabela a seguir descreve cada elemento.The following table describes each element.

ElementoElement DescriçãoDescription
wsws Espaço em branco opcional.Optional white space. O espaço em branco pode aparecer no início s de style se incluir NumberStyles.AllowLeadingWhite o sinalizador ou no final de s se style incluir o NumberStyles.AllowTrailingWhite sinalizador.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.
$ Um símbolo de moeda específico de cultura.A culture-specific currency symbol. A posição na cadeia de caracteres é definida pela propriedade CurrencyPositivePattern do objeto NumberFormatInfo retornado pelo método GetFormat do parâmetro provider.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. O símbolo de moeda pode ser exibido em s caso style inclua o sinalizador NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Um sinal opcional.An optional sign. O sinal pode ser exibido no início de s caso style inclua o sinalizador NumberStyles.AllowLeadingSign e ele pode ser exibido no final de s caso style inclua o sinalizador 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. Os parênteses podem ser usados em s para indicar um valor negativo caso style inclua o sinalizador NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. No entanto, se o sinal negativo estiver s presente, o só poderá representar o valor zero para a operação de análise ter sucesso.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.
digitsdigits Uma sequência de dígitos de 0 a 9.A sequence of digits from 0 through 9.
,, Um separador de grupo específico de cultura.A culture-specific group separator. O separador de grupo da cultura provider especificada por pode s aparecer style em se NumberStyles.AllowThousands incluir o sinalizador.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Um símbolo de vírgula decimal específico de cultura.A culture-specific decimal point symbol. O símbolo da vírgula decimal da cultura especificada por provider pode ser exibido em s caso style inclua o sinalizador NumberStyles.AllowDecimalPoint.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Uma ou mais ocorrências de dígito 0.One or more occurrences of the digit 0. Os dígitos fracionários só podem ser exibidos em s caso style inclua o sinalizador NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
EE O caractere "e" ou "E", que indica que o valor é representado em notação exponencial (científica).The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. O parâmetro s pode representar um número em notação exponencial caso style inclua o sinalizador NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits Uma sequência de dígitos de 0 a 9.A sequence of digits from 0 through 9. O parâmetro s pode representar um número em notação exponencial caso style inclua o sinalizador NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Uma sequência de dígitos hexadecimais de 0 a f ou de 0 a F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Observação

Todos os caracteres nul (U + 0000) de s encerramento são ignorados pela operação de análise, independentemente do valor style do argumento.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Uma cadeia de caracteres apenas com dígitos decimais (que corresponde ao sinalizador NumberStyles.None ) sempre é analisada com êxito.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. A maioria dos elementos de controle de membros NumberStyles restantes que podem estar presentes, mas que não precisam estar presentes, na cadeia de caracteres de entrada.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. A tabela a seguir indica como os membros NumberStyles individuais afetam os elementos que podem estar presentes em s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valores NumberStyles não compostosNon-composite NumberStyles values Elementos permitidos no valor além de dígitosElements permitted in value in addition to digits
None Somente dígitos decimais.Decimal digits only.
AllowDecimalPoint Os elementos de ponto decimal (.) e fractional_digits .The decimal point (.) and fractional_digits elements. No entanto, fractional_digits deve consistir apenas de um ou mais 0 dígitos ou o falsemétodo retorna.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent O caractere "e" ou "E", que indica notação exponencial, junto com exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Se s representa um número em notação exponencial, ele não pode ter um componente fracionário diferente de zero.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite O elemento WS no início de s.The ws element at the start of s.
AllowTrailingWhite O elemento ws no final de s.The ws element at the end of s.
AllowLeadingSign O elemento Sign antes dos dígitos.The sign element before digits.
AllowTrailingSign O elemento Sign após dígitos.The sign element after digits.
AllowParentheses O elemento Sign na forma de parênteses delimitando um valor numérico zero.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands O elemento separador de grupo (,).The group separator (,) element.
AllowCurrencySymbol O elemento Currency$().The currency ($) element.
Currency Todos os elementos.All elements. No entanto, s não pode representar um número hexadecimal ou um número em notação exponencial.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float O elemento WS no início ou no final de s, entre no início de se no símbolo de ponto decimal (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. O parâmetro s também pode usar notação exponencial.The s parameter can also use exponential notation.
Number Os elementos WS, Sign, Group separador (,) e ponto decimal (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Todos os elementos.All elements. No entanto, s não pode representar um número hexadecimal.However, s cannot represent a hexadecimal number.

Caso o sinalizador NumberStyles.AllowHexSpecifier seja usado, s deve ser um valor hexadecimal.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Os únicos outros sinalizadores que podem estar presentes em style são NumberStyles.AllowLeadingWhite e NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (A enumeração NumberStyles tem um estilo composto, HexNumber, que inclui ambos os sinalizadores de espaço em branco.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Observação

Caso s seja a representação da cadeia de caracteres de um número hexadecimal, ele não pode ser precedido por qualquer decoração (como 0x ou &h) que o diferencia como um número hexadecimal.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. Isso faz a conversão falhar.This causes the conversion to fail.

O parâmetro provider é uma implementação de IFormatProvider.The provider parameter is an IFormatProvider implementation. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato de s.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. O parâmetro provider pode ser qualquer um dos seguintes:The provider parameter can be any one of the following:

  • Um objeto CultureInfo que representa a cultura que fornece informações de formatação.A CultureInfo object that represents the culture that supplies formatting information. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Um objeto NumberFormatInfo que fornece informações de formatação numérica.A NumberFormatInfo object that provides numeric formatting information. (Sua implementação de GetFormat retorna apenas ele próprio.)(Its implementation of GetFormat just returns itself.)

  • Um objeto personalizado que implementa IFormatProvider.A custom object that implements IFormatProvider. O método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Caso provider seja null, o objeto NumberFormatInfo da cultura atual é usado.If provider is null, the NumberFormatInfo object for the current culture is used.

Veja também

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

Importante

Esta API não está em conformidade com 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 *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) As Boolean

Parâmetros

Retornos

Aplica-se a