Compartilhar via


nfloat.Parse Método

Definição

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 providerou 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

Retornos

Aplica-se a