nfloat.Parse Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
Parse(String) |
Converte a representação da cadeia de caracteres de um número no equivalente do número de ponto flutuante de precisão dupla. |
Parse(String, NumberStyles) | |
Parse(String, IFormatProvider) |
Converte a representação de cadeia de caracteres de um número em um formato específico da cultura para o número de ponto flutuante de precisão dupla equivalente. |
Parse(String, NumberStyles, IFormatProvider) |
Parse(String)
Converte a representação da cadeia de caracteres de um número no equivalente do número de ponto flutuante de precisão dupla.
public static nfloat Parse (string s);
static member Parse : string -> nfloat
Parâmetros
- s
- String
Uma cadeia de caracteres que contém um número a ser convertido.
Retornos
Um número de ponto flutuante nfloat equivalente ao valor numérico ou símbolo especificado em s
.
Comentários
O s
parâmetro pode conter a cultura P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol, P:System.Globalization.NumberFormatInfo.NaNSymbol, ou uma cadeia de caracteres do formulário:
[ws] [sign] [integral-digits[,]]integral-digits[.[ fractional-digits]][E[sign]exponential-digits][ws]
Os elementos entre colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Uma série de caracteres de espaço em branco. |
sinal | Um símbolo de sinal negativo (-) ou um símbolo de sinal positivo (+). Somente um sinal à esquerda pode ser usado. |
dígitos integrais | Uma série de dígitos que varia de 0 a 9 que especificam a parte integral do número. As execuções de dígitos integrais podem ser particionadas por um símbolo separador de grupo. Por exemplo, em algumas culturas, uma vírgula (,) separa grupos de milhares. O elemento dígitos integrais pode ser ausente caso a cadeia de caracteres contenha o elemento dígitos fracionários. |
, | Um símbolo de separador de milhares específico da cultura. |
. | Um símbolo de vírgula decimal específico de cultura. |
dígitos fracionários | Uma série de dígitos que varia de 0 a 9 que especificam a parte fracionária do número. |
E | O caractere "e" ou "E", que indica que o valor é representado em notação exponencial (científica). |
dígitos exponenciais | Uma série de dígitos que varia de 0 a 9 que especificam um expoente. |
O s
parâmetro é interpretado usando uma combinação dos sinalizadores F:System.Globalization.NumberStyles.Float e F:System.Globalization.NumberStyles.AllowThousands . Isso significa que o espaço em branco e milhares de separadores são permitidos, por exemplo, enquanto os símbolos de moeda não são. Para obter um controle mais fino sobre em quais elementos de estilo são permitidos s
para que a operação de análise tenha êxito, chame m M:System.Double.Parse(System.String,System.Globalization.NumberStyles) ou M:System.Double.Parse(System.String,System.Globalization.NumberStyles, Método System.IFormatProvider ).
O s
parâmetro é interpretado usando as informações de formatação em um objeto T:System.Globalization.NumberFormatInfo inicializado para a cultura de thread atual. Para obter mais informações, consulte P:System.Globalization.NumberFormatInfo.CurrentInfo. Para analisar uma cadeia de caracteres usando as informações de formatação de alguma outra cultura, chame M:System.Double.Parse(System.String,System.IFormatProvider) ou M:System.Double.Parse(System.String,System.Globalization.NumberStyles,System.IFormatProvider) método.
Normalmente, se você passar o método M:System.Double.Parse* uma cadeia de caracteres criada chamando o método M:System.Double.ToString* , o valor T:System.Double original será retornado. No entanto, por conta de uma perda de precisão, os valores talvez não sejam iguais. Além disso, tentar analisar a representação de cadeia de caracteres de F:System.Double.MinValue ou F:System.Double.MaxValue lança um T:System.OverflowException, como ilustra o exemplo a seguir.
referência de código: System.Double.Parse#3
Caso um separador esteja no parâmetro s
durante uma operação de análise e a moeda aplicável ou os separadores de casa decimal e grupo sejam iguais, a operação de análise pressupõe que o separador seja um separador decimal, e não um separador de grupo. Para obter mais informações sobre separadores, consulte P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator e P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Aplica-se a
Parse(String, NumberStyles)
public static nfloat Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> nfloat
Parâmetros
- s
- String
- style
- NumberStyles
Retornos
Aplica-se a
Parse(String, IFormatProvider)
Converte a representação de cadeia de caracteres de um número em um formato específico da cultura para o número de ponto flutuante de precisão dupla equivalente.
public static nfloat Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> nfloat
Parâmetros
- s
- String
Uma cadeia de caracteres que contém um número a ser convertido.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas de cultura sobre s
.
Retornos
Um número de ponto flutuante nfloat equivalente ao valor numérico ou símbolo especificado em s
.
Comentários
Essa sobrecarga do Parse(String, IFormatProvider) método normalmente é usada para converter texto que pode ser formatado de várias maneiras para um nfloat valor. Por exemplo, ele pode ser usado para converter o texto inserido por um usuário em uma caixa de texto HTML em um valor numérico.
O s
parâmetro é interpretado usando uma combinação dos sinalizadores F:System.Globalization.NumberStyles.Float e F:System.Globalization.NumberStyles.AllowThousands . O s
parâmetro pode conter P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol ou P:System.Globalization.NumberFormatInfo.NaNSymbol para a cultura especificado por provider
ou pode conter uma cadeia de caracteres do formulário:
[ws] [sign]integral-digits[.[ fractional-digits]][E[sign]exponential-digits][ws]
Os elementos opcionais são colocados entre colchetes ([ e ]). Os elementos que contêm o termo "digits" consistem em uma série de caracteres numéricos que varia de 0 a 9.
Elemento | Descrição |
---|---|
ws | Uma série de caracteres de espaço em branco. |
sinal | Um símbolo de sinal negativo (-) ou um símbolo de sinal positivo (+). |
dígitos integrais | Uma série de dígitos que varia de 0 a 9 que especificam a parte integral do número. As execuções de dígitos integrais podem ser particionadas por um símbolo separador de grupo. Por exemplo, em algumas culturas, uma vírgula (,) separa grupos de milhares. O elemento dígitos integrais pode ser ausente caso a cadeia de caracteres contenha o elemento dígitos fracionários. |
. | Um símbolo de vírgula decimal específico de cultura. |
dígitos fracionários | Uma série de dígitos que varia de 0 a 9 que especificam a parte fracionária do número. |
E | O caractere "e" ou "E", que indica que o valor é representado em notação exponencial (científica). |
dígitos exponenciais | Uma série de dígitos que varia de 0 a 9 que especificam um expoente. |
O provider
parâmetro é uma implementação T:System.IFormatProvider cujo método M:System.IFormatProvider.GetFormat(System.Type) retorna um objeto T:System.Globalization.NumberFormatInfo que fornece informações específicas da cultura usadas na interpretação do formato de s
. Normalmente, é um objeto T:System.Globalization.NumberFormatInfo ou T:System.Globalization.CultureInfo . Se provider
for nulo ou não for possível obter um T:System.Globalization.NumberFormatInfo , as informações de formatação para a cultura atual do sistema serão usadas.
Normalmente, se você passar o método M:System.nfloat.Parse* uma cadeia de caracteres criada chamando o método M:System.nfloat.ToString* , o valor original nfloat será retornado. No entanto, por conta de uma perda de precisão, os valores talvez não sejam iguais. Além disso, tentar analisar a representação de cadeia de caracteres de MinValue ou MaxValue lançar um T:System.OverflowException.
Caso um separador esteja no parâmetro s
durante uma operação de análise e a moeda aplicável ou os separadores de casa decimal e grupo sejam iguais, a operação de análise pressupõe que o separador seja um separador decimal, e não um separador de grupo. Para obter mais informações sobre separadores, consulte P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator e P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Aplica-se a
Parse(String, NumberStyles, IFormatProvider)
public static nfloat Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> nfloat
Parâmetros
- s
- String
- style
- NumberStyles
- provider
- IFormatProvider