Int64.TryParse Int64.TryParse Int64.TryParse Int64.TryParse Method

Definição

Converte a representação de cadeia de caracteres de um número no inteiro com sinal de 64 bits equivalente.Converts the string representation of a number to its 64-bit signed 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, Int64) TryParse(String, Int64) TryParse(String, Int64) TryParse(String, Int64)

Converte a representação de cadeia de caracteres de um número no inteiro com sinal de 64 bits equivalente.Converts the string representation of a number to its 64-bit signed 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>, Int64) TryParse(ReadOnlySpan<Char>, Int64) TryParse(ReadOnlySpan<Char>, Int64) TryParse(ReadOnlySpan<Char>, Int64)
TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64)

Converte a representação de cadeia de caracteres de um número em um estilo e formato específico da cultura especificados em seu equivalente de inteiro com sinal de 64 bits.Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed 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, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64)

TryParse(String, Int64) TryParse(String, Int64) TryParse(String, Int64) TryParse(String, Int64)

Converte a representação de cadeia de caracteres de um número no inteiro com sinal de 64 bits equivalente.Converts the string representation of a number to its 64-bit signed 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] long % result);
public static bool TryParse (string s, out long result);
static member TryParse : string * int64 -> bool
Public Shared Function TryParse (s As String, ByRef result As Long) As Boolean

Parâmetros

s
String String String String

Uma cadeia de caracteres que contém um número a ser convertido.A string containing a number to convert.

result
Int64 Int64 Int64 Int64

Quando esse método retornar, conterá o equivalente do valor inteiro com sinal de 64 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 64-bit signed integer value equivalent of 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 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 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 Int64.TryParse(String, Int64) o método com um número de valores de cadeia de caracteres diferentes.The following example calls the Int64.TryParse(String, Int64) method with a number of different string values.

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("160519");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      bool success = Int64.TryParse(value, out long number);
      if (success)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);         
      }
      else
      {
         if (value == null) value = ""; 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '160519' to 160519.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100);' failed.
//       Attempted conversion of '01FA' failed.
Module StringParsing
   Public Sub Main()
      TryToParse(Nothing)
      TryToParse("160519")
      TryToParse("9432.0")
      TryToParse("16,667")
      TryToParse("   -322   ")
      TryToParse("+4302")
      TryToParse("(100)")
      TryToParse("01FA")
   End Sub
   
   Private Sub TryToParse(value As String)
      Dim number As Long
      Dim result As Boolean = Int64.TryParse(value, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Else
         If value Is Nothing Then value = "" 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value)
      End If     
   End Sub
End Module
' The example displays the following output to the console:
'       Attempted conversion of '' failed.
'       Converted '160519' to 160519.
'       Attempted conversion of '9432.0' failed.
'       Attempted conversion of '16,667' failed.
'       Converted '   -322   ' to -322.
'       Converted '+4302' to 4302.
'       Attempted conversion of '(100)' failed.
'       Attempted conversion of '01FA' failed.

Algumas das cadeias de caracteres TryParse(String, Int64) que o método não pode converter neste exemplo são:Some of the strings that the TryParse(String, Int64) method is unable to convert in this example are:

  • "9432.0"."9432.0". A conversão falha porque a cadeia de caracteres não pode conter um separador decimal; Ele deve conter apenas dígitos integrais.The conversion fails because the string cannot contain a decimal separator; it must contain integral digits only.

  • "16,667"."16,667". A conversão falha porque a cadeia de caracteres não pode conter separadores de grupo; Ele deve conter apenas dígitos integrais.The conversion fails because the string cannot contain group separators; it must contain integral digits only.

  • "(100)"."(100)". A conversão falha porque a cadeia de caracteres não pode conter um sinal negativo diferente daquele definido pelas propriedades NumberFormatInfo.NegativeSign e NumberFormatInfo.NumberNegativePattern culturas atuais.The conversion fails because the string cannot contain a negative sign other than the one defined by the current culture's NumberFormatInfo.NegativeSign and NumberFormatInfo.NumberNegativePattern properties.

  • "01FA"."01FA". A conversão falha porque a cadeia de caracteres não pode conter dígitos hexadecimais; Ele deve conter apenas dígitos decimais.The conversion fails because the string cannot contain hexadecimal digits; it must contain decimal digits only.

Comentários

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

O parâmetro s contém um número da forma:The s parameter contains a number of the 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 Um espaço em branco opcional.An optional white space.
signsign Um sinal opcional.An optional sign.
digitsdigits Uma sequência de dígitos que varia de 0 a 9.A sequence of digits ranging from 0 to 9.

O parâmetro s é interpretado usando-se o estilo NumberStyles.Integer.The s parameter is interpreted using the NumberStyles.Integer style. Além dos dígitos decimais, são permitidos apenas espaços à esquerda e à direita, juntamente com um sinal à esquerda.In addition to the decimal digits, only leading and trailing spaces together with a leading sign are allowed. Para definir explicitamente os elementos de estilo junto com as informações de formatação específicas de cultura que podem estar spresentes no, TryParse(String, NumberStyles, IFormatProvider, Int64) use o método.To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the TryParse(String, NumberStyles, IFormatProvider, Int64) method.

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

Essa sobrecarga do TryParse método interpreta todos os dígitos s no parâmetro como dígitos decimais.This overload of the TryParse method 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, Int64) , chame a sobrecarga.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, Int64) overload.

Veja também

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

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] long % result);
public static bool TryParse (ReadOnlySpan<char> s, out long result);
static member TryParse : ReadOnlySpan<char> * int64 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Long) As Boolean

Parâmetros

Retornos

TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64) TryParse(String, NumberStyles, IFormatProvider, Int64)

Converte a representação de cadeia de caracteres de um número em um estilo e formato específico da cultura especificados em seu equivalente de inteiro com sinal de 64 bits.Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed 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] long % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out long result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * int64 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Long) As Boolean

Parâmetros

s
String String String String

Uma cadeia de caracteres que contém um número a ser convertido.A string containing a number to convert. A cadeia de caracteres é interpretada usando-se o estilo especificado por style.The string is interpreted using the style specified by style.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Um combinação bit a bit de valores de enumeração que indica os elementos de estilo que podem estar presentes em s.A bitwise combination of enumeration values that indicates the style elements that can be present in 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
Int64 Int64 Int64 Int64

Quando esse método retornar, conterá o equivalente do valor inteiro com sinal de 64 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 64-bit signed integer value equivalent of 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 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, Int64) o método com um número de cadeias NumberStyles de caracteres e valores diferentes.The following example calls the TryParse(String, NumberStyles, IFormatProvider, Int64) method with a number of different string and NumberStyles values.

using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106779";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.AllowLeadingSign;
      CallTryParse(numericString, styles);
      
      numericString = "301677-";
      CallTryParse(numericString, styles);
      
      styles = styles | NumberStyles.AllowTrailingSign;
      CallTryParse(numericString, styles);
      
      numericString = "$10634";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.Integer | NumberStyles.AllowCurrencySymbol;
      CallTryParse(numericString, styles);
      
      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);
      
      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
          
      numericString = "12E03";
      CallTryParse(numericString, styles); 
      
      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);      
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      CultureInfo provider;
      
      // If currency symbol is allowed, use en-US culture.
      if ((styles & NumberStyles.AllowCurrencySymbol) > 0)
         provider = new CultureInfo("en-US");
      else
         provider = CultureInfo.InvariantCulture;
            
      bool success = Int64.TryParse(stringToConvert, styles,
                                   provider, out long number);
      if (success)
         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 to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106779"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.AllowLeadingSign
      CallTryParse(numericString, styles)
      
      numericString = "301677-"
      CallTryParse(numericString, styles)
      
      styles = styles Or NumberStyles.AllowTrailingSign
      CallTryParse(numericString, styles)
      
      numericString = "$10634"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.Integer Or NumberStyles.AllowCurrencySymbol
      CallTryParse(numericString, styles)

      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Long
      Dim provider As CultureInfo
      
      ' If currency symbol is allowed, use en-US culture.
      If CBool(styles And NumberStyles.AllowCurrencySymbol) Then
         provider = CultureInfo.CurrentCulture
      Else
         provider = New CultureInfo("en-US")
      End If
      
      Dim result As Boolean = Int64.TryParse(stringToConvert, styles, _
                                             provider, 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 '106779' to 106779.
'       Attempted conversion of '-30677' failed.
'       Converted '-30677' to -30677.
'       Attempted conversion of '301677-' failed.
'       Converted '301677-' to -301677.
'       Attempted conversion of '$10634' failed.
'       Converted '$10634' to 10634.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to 32961.
'       Attempted conversion of '0x80C1' failed.

Comentários

O TryParse método é como o Parse método, exceto pelo TryParse fato de o método não lançar uma exceção se a conversão falhar.The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails. Ele elimina a necessidade de usar a manipulação de exceções para testar FormatException um caso que s seja inválido e não possa ser analisado com êxito.It eliminates the need to use exception handling to test for a FormatException in the event that 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 s parâmetro pode incluir os seguintes elementos: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]

Ou, se o style parâmetro incluir NumberStyles.AllowHexSpecifier:Or, if the style parameter includes NumberStyles.AllowHexSpecifier:

[ws]hexdigits[ws][ws]hexdigits[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. O espaço em branco pode ser exibido no início de s caso style inclua o sinalizador NumberStyles.AllowLeadingWhite ou no final de s caso style inclua o sinalizador NumberStyles.AllowTrailingWhite.White space can appear at the beginning 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. Um símbolo de sinal pode aparecer s no style se incluir NumberStyles.AllowLeadingSign os NumberStyles.AllowTrailingSign sinalizadores ou.A sign symbol can appear in s if style includes the NumberStyles.AllowLeadingSign or NumberStyles.AllowTrailingSign flags.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Uma sequência de dígitos de 0 a 9.A sequence of digits from 0 through 9. Para fractional_digits, apenas o dígito 0 é válido.For fractional_digits, only the digit 0 is valid.
,, Um separador de milhares específico de cultura.A culture-specific thousands separator. O separador de milhares da cultura especificada por provider pode ser exibido em s caso style inclua o sinalizador NumberStyles.AllowThousands.The thousands 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.
ee O caractere 'e' ou 'E', que indica se o valor é representado na notação exponencial.The 'e' or 'E' character, which indicates that the value is represented in exponential 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.
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 dos membros NumberStyles restantes que podem estar, mas que não precisam estar presentes nessa cadeia de caracteres de entrada.Most of the remaining NumberStyles members control elements that may be 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 em s além de dígitosElements permitted in s in addition to digits
NumberStyles.None Somente dígitos decimais.Decimal digits only.
NumberStyles.AllowDecimalPoint O ponto decimal ( .The decimal point ( . ) e elementos fractional_digits .) and fractional_digits elements. No entanto, fractional_digits deve consistir apenas de um ou mais 0 dígitos ou falseo método retorna.However, fractional_digits must consist of only one or more 0 digits or the method returns false.
NumberStyles.AllowExponent O parâmetro s também pode usar notação exponencial.The s parameter can also use exponential notation. O s parâmetro deve representar um inteiro dentro do intervalo Int64 do tipo de dados sem um componente fracionário diferente de zero.The s parameter must represent an integer within the range of the Int64 data type without a non-zero fractional component.
NumberStyles.AllowLeadingWhite O elemento ws no início de s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite O elemento ws no final de s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Um sinal pode aparecer antes dos dígitos.A sign can appear before digits.
NumberStyles.AllowTrailingSign Um sinal pode aparecer após dígitos.A sign can appear after digits.
NumberStyles.AllowParentheses O elemento sinal na forma de parênteses que incluem o valor numérico.The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands O elemento separador de milhares ( . ).The thousands separator ( , ) element.
NumberStyles.AllowCurrencySymbol O elemento é $.The $ element.
NumberStyles.Currency Todos os elementos.All elements. O parâmetro s não pode representar um número hexadecimal ou um número em notação exponencial.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
NumberStyles.Float O elemento ws no início ou fim de s, sinal no início de s** e o símbolo de vírgula decimal (,).The ws element at the beginning or end of s, sign at the beginning of s, and the decimal point ( . símbolo.) symbol. O parâmetro s também pode usar notação exponencial.The s parameter can also use exponential notation.
NumberStyles.Number Os elementos WS, Sign, milhar (,) e decimal (.).The ws, sign, thousands separator (,), and decimal point (.) elements.
NumberStyles.Any Todos os estilos, exceto caso s não possa representar um número hexadecimal.All styles, except s cannot represent a hexadecimal number.

Se o NumberStyles.AllowHexSpecifier sinalizador for usado, s deverá ser um valor hexadecimal sem um prefixo.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Por exemplo, "C9AF3" analisa com êxito, mas "0xC9AF3" não.For example, "C9AF3" parses successfully, but "0xC9AF3" does not. 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 NumberStyles enumeração tem um estilo composto, NumberStyles.HexNumber, que inclui os dois sinalizadores de espaço em branco.)(The NumberStyles enumeration has a composite style, NumberStyles.HexNumber, that includes both white space flags.)

O parâmetro provider é uma implementação de IFormatProvider, como um objeto CultureInfo ou um objeto NumberFormatInfo, cujo método GetFormat retorna um objeto NumberFormatInfo.The provider parameter is an IFormatProvider implementation, such as a CultureInfo object or a NumberFormatInfo object, whose GetFormat method returns a NumberFormatInfo object. O objeto NumberFormatInfo fornece informações específicas da cultura sobre o formato de s.The NumberFormatInfo object provides culture-specific information about the format of s. 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, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64)

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

Parâmetros

Retornos

Aplica-se a