Decimal.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.
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente.
Sobrecargas
Parse(String) |
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente. |
Parse(ReadOnlySpan<Byte>, IFormatProvider) |
Analisa um intervalo de caracteres UTF-8 em um valor. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analisa um intervalo de caracteres em um valor. |
Parse(String, NumberStyles) |
Converte a representação de cadeia de caracteres de um número em um estilo especificado em seu Decimal equivalente. |
Parse(String, IFormatProvider) |
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando as informações de formato específicas da cultura especificadas. |
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider) |
Analisa um intervalo de caracteres UTF-8 em um valor. |
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) |
Converte a representação de intervalo de um número em seu Decimal equivalente usando o estilo especificado e o formato específico da cultura. |
Parse(String, NumberStyles, IFormatProvider) |
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando o formato específico de estilo e cultura especificados. |
Parse(String)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente.
public:
static System::Decimal Parse(System::String ^ s);
public static decimal Parse (string s);
static member Parse : string -> decimal
Public Shared Function Parse (s As String) As Decimal
Parâmetros
- s
- String
A representação de cadeia de caracteres do número a ser convertido.
Retornos
O equivalente ao número contido em s
.
Exceções
s
é null
.
s
não está no formato correto.
s
representa um número menor que Decimal.MinValue ou maior que Decimal.MaxValue.
Exemplos
O exemplo de código a seguir usa o método Parse(String) para analisar representações de cadeia de caracteres de valores Decimal.
string value;
decimal number;
// Parse an integer with thousands separators.
value = "16,523,421";
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '16,523,421' converted to 16523421.
// Parse a floating point value with thousands separators
value = "25,162.1378";
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '25,162.1378' converted to 25162.1378.
// Parse a floating point number with US currency symbol.
value = "$16,321,421.75";
try
{
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
// Unable to parse '$16,321,421.75'.
// Parse a number in exponential notation
value = "1.62345e-02";
try
{
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
// Unable to parse '1.62345e-02'.
// Parse an integer with thousands separators.
let value = "16,523,421"
let number = Decimal.Parse value
printfn $"'{value}' converted to {number}."
// Displays:
// '16,523,421' converted to 16523421.
// Parse a floating point value with thousands separators
let value = "25,162.1378"
let number = Decimal.Parse value
printfn $"'{value}' converted to {number}."
// Displays:
// '25,162.1378' converted to 25162.1378.
// Parse a floating point number with US currency symbol.
let value = "$16,321,421.75"
try
let number = Decimal.Parse value
printfn $"'{value}' converted to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}'."
// Displays:
// Unable to parse '$16,321,421.75'.
// Parse a number in exponential notation
let value = "1.62345e-02"
try
let number = Decimal.Parse value
printfn $"'{value}' converted to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}'."
// Displays:
// Unable to parse '1.62345e-02'.
Dim value As String
Dim number As Decimal
' Parse an integer with thousands separators.
value = "16,523,421"
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '16,523,421' converted to 16523421.
' Parse a floating point value with thousands separators
value = "25,162.1378"
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '25,162.1378' converted to 25162.1378.
' Parse a floating point number with US currency symbol.
value = "$16,321,421.75"
Try
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
' Unable to parse '$16,321,421.75'.
' Parse a number in exponential notation
value = "1.62345e-02"
Try
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
' Unable to parse '1.62345e-02'.
Comentários
O parâmetro s
contém um número do formulário:
[ws] [sign] [dígitos,]dígitos[.fractional-digits][ws]
Elementos em colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Espaço em branco opcional. |
assinar | Um sinal opcional. |
dígitos | Uma sequência de dígitos variando de 0 a 9. |
, | Um símbolo separador de milhares específico à cultura. |
. | Um símbolo de ponto decimal específico da cultura. |
de dígitos fracionários | Uma sequência de dígitos variando de 0 a 9. |
O parâmetro s
é interpretado usando o estilo NumberStyles.Number. Isso significa que o espaço em branco e milhares de separadores são permitidos, mas os símbolos de moeda não são. Para definir explicitamente os elementos (como símbolos de moeda, milhares de separadores e espaço em branco) que podem estar presentes em s
, use o Decimal.Parse(String, NumberStyles) ou o método Decimal.Parse(String, NumberStyles, IFormatProvider).
O parâmetro s
é analisado usando as informações de formatação em um NumberFormatInfo inicializado para a cultura atual do sistema. Para obter mais informações, consulte CurrentInfo. Para analisar uma cadeia de caracteres usando as informações de formatação de alguma outra cultura, use o método Decimal.Parse(String, IFormatProvider) ou Decimal.Parse(String, NumberStyles, IFormatProvider).
Se necessário, o valor de s
será arredondado usando o arredondamento para o mais próximo.
Um Decimal tem 29 dígitos de precisão. Se s
representar um número com mais de 29 dígitos, mas tiver uma parte fracionária e estiver dentro do intervalo de MaxValue e MinValue, o número será arredondado, não truncado, para 29 dígitos usando arredondamento para mais próximo.
Se durante uma operação de análise um separador for encontrado no parâmetro s
, e a moeda ou o número decimal aplicável e separadores de grupo forem os mesmos, a operação de análise pressupõe que o separador seja um separador decimal em vez de um separador de grupo. Para obter mais informações sobre separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatore NumberGroupSeparator.
Confira também
Aplica-se a
Parse(ReadOnlySpan<Byte>, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Analisa um intervalo de caracteres UTF-8 em um valor.
public:
static System::Decimal Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<System::Decimal>::Parse;
public static decimal Parse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);
static member Parse : ReadOnlySpan<byte> * IFormatProvider -> decimal
Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Decimal
Parâmetros
- utf8Text
- ReadOnlySpan<Byte>
O intervalo de caracteres UTF-8 a serem analisados.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura sobre utf8Text
.
Retornos
O resultado da análise de utf8Text
.
Implementações
Aplica-se a
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Analisa um intervalo de caracteres em um valor.
public:
static System::Decimal Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<System::Decimal>::Parse;
public static decimal Parse (ReadOnlySpan<char> s, IFormatProvider? provider);
static member Parse : ReadOnlySpan<char> * IFormatProvider -> decimal
Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Decimal
Parâmetros
- s
- ReadOnlySpan<Char>
O intervalo de caracteres a serem analisados.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura sobre s
.
Retornos
O resultado da análise de s
.
Implementações
Aplica-se a
Parse(String, NumberStyles)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Converte a representação de cadeia de caracteres de um número em um estilo especificado em seu Decimal equivalente.
public:
static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static decimal Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> decimal
Public Shared Function Parse (s As String, style As NumberStyles) As Decimal
Parâmetros
- s
- String
A representação de cadeia de caracteres do número a ser convertido.
- style
- NumberStyles
Uma combinação bit a bit de valores NumberStyles que indica os elementos de estilo que podem estar presentes em s
. Um valor típico a ser especificado é Number.
Retornos
O número de Decimal equivalente ao número contido em s
conforme especificado por style
.
Exceções
s
é null
.
s
não está no formato correto.
s
representa um número menor que Decimal.MinValue ou maior que Decimal.MaxValue
Exemplos
O exemplo de código a seguir usa o método Parse(String, NumberStyles) para analisar as representações de cadeia de caracteres de valores Decimal usando a cultura en-US.
string value;
decimal number;
NumberStyles style;
// Parse string with a floating point value using NumberStyles.None.
value = "8694.12";
style = NumberStyles.None;
try
{
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
// Unable to parse '8694.12'.
// Parse string with a floating point value and allow decimal point.
style = NumberStyles.AllowDecimalPoint;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '8694.12' converted to 8694.12.
// Parse string with negative value in parentheses
value = "(1,789.34)";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands |
NumberStyles.AllowParentheses;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '(1,789.34)' converted to -1789.34.
// Parse string using Number style
value = " -17,623.49 ";
style = NumberStyles.Number;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// ' -17,623.49 ' converted to -17623.49.
// Parse string with a floating point value using NumberStyles.None.
let value = "8694.12"
let style = NumberStyles.None
try
let number = Decimal.Parse(value, style)
printfn $"'{value}' converted to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}'."
// Displays:
// Unable to parse '8694.12'.
// Parse string with a floating point value and allow decimal point.
let style = NumberStyles.AllowDecimalPoint
let number = Decimal.Parse(value, style)
printfn $"'{value}' converted to {number}."
// Displays:
// '8694.12' converted to 8694.12.
// Parse string with negative value in parentheses
let value = "(1,789.34)"
let style =
NumberStyles.AllowDecimalPoint |||
NumberStyles.AllowThousands |||
NumberStyles.AllowParentheses
let number = Decimal.Parse(value, style)
printfn $"'{value}' converted to {number}."
// Displays:
// '(1,789.34)' converted to -1789.34.
// Parse string using Number style
let value = " -17,623.49 "
let style = NumberStyles.Number
let number = Decimal.Parse(value, style)
printfn $"'{value}' converted to {number}."
// Displays:
// ' -17,623.49 ' converted to -17623.49.
Dim value As String
Dim number As Decimal
Dim style As NumberStyles
' Parse string with a floating point value using NumberStyles.None.
value = "8694.12"
style = NumberStyles.None
Try
number = Decimal.Parse(value, style)
Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
' Unable to parse '8694.12'.
' Parse string with a floating point value and allow decimal point.
style = NumberStyles.AllowDecimalPoint
number = Decimal.Parse(value, style)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '8694.12' converted to 8694.12.
' Parse string with negative value in parentheses
value = "(1,789.34)"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands Or _
NumberStyles.AllowParentheses
number = Decimal.Parse(value, style)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '(1,789.34)' converted to -1789.34.
' Parse string using Number style
value = " -17,623.49 "
style = NumberStyles.Number
number = Decimal.Parse(value, style)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' ' -17,623.49 ' converted to -17623.49.
Comentários
O parâmetro style
define os elementos de estilo (como milhares de separadores, espaço em branco e símbolos de moeda) que são permitidos no parâmetro s
para que a operação de análise tenha êxito. Deve ser uma combinação de sinalizadores de bits da enumeração NumberStyles. Não há suporte para os seguintes membros NumberStyles:
Dependendo do valor de style
, o parâmetro s
pode incluir os seguintes elementos:
[ws] [$] [sign] [dígitos,]dígitos[.fractional-digits][e[sign]digits][ws]
Elementos em colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Espaço em branco opcional. O espaço em branco poderá aparecer no início do s se style incluir o sinalizador NumberStyles.AllowLeadingWhite e ele poderá aparecer no final do s se style incluir o sinalizador NumberStyles.AllowTrailingWhite. |
$ | Um símbolo de moeda específico à cultura. Sua posição na cadeia de caracteres é definida pelas propriedades NumberFormatInfo.CurrencyNegativePattern e NumberFormatInfo.CurrencyPositivePattern da cultura atual. O símbolo de moeda da cultura atual pode aparecer em s se style incluir o sinalizador NumberStyles.AllowCurrencySymbol. |
assinar | Um sinal opcional. O sinal poderá aparecer no início do s se style incluir o sinalizador de NumberStyles.AllowLeadingSign e ele poderá aparecer no final do s se style incluir o sinalizador NumberStyles.AllowTrailingSign. Parênteses podem ser usados em s para indicar um valor negativo se style incluir o sinalizador NumberStyles.AllowParentheses. |
dígitos | Uma sequência de dígitos variando de 0 a 9. |
, | Um símbolo separador de milhares específico à cultura. O separador de milhares da cultura atual pode aparecer em s se style incluir o sinalizador NumberStyles.AllowThousands. |
. | Um símbolo de ponto decimal específico da cultura. O símbolo de ponto decimal da cultura atual pode aparecer em s se style incluir o sinalizador NumberStyles.AllowDecimalPoint. |
de dígitos fracionários | Uma sequência de dígitos variando de 0 a 9. Dígitos fracionários só poderão aparecer em s se style incluir o sinalizador NumberStyles.AllowDecimalPoint. |
e | O caractere 'e' ou 'E', que indica que o valor é representado na notação exponencial. O parâmetro s pode representar um número na notação exponencial se style incluir o sinalizador NumberStyles.AllowExponent. |
Nota
Todos os caracteres NUL de terminação (U+0000) em s
são ignorados pela operação de análise, independentemente do valor do argumento style
.
Uma cadeia de caracteres somente com dígitos (que corresponde ao estilo None) sempre será analisada com êxito se estiver no intervalo do tipo Decimal. Os membros restantes NumberStyles controlam elementos que podem estar, mas não precisam estar presentes na cadeia de caracteres de entrada. A tabela a seguir indica como membros NumberStyles individuais afetam os elementos que podem estar presentes no s
.
Valor de NumberStyles | Elementos permitidos em s além de dígitos |
---|---|
None | O dígitos elemento somente. |
AllowDecimalPoint | O . e elementos de dígitos fracionários. |
AllowExponent | O parâmetro s também pode usar notação exponencial. Esse sinalizador dá suporte a valores no formulário dígitosdígitos E; sinalizadores adicionais são necessários para analisar com êxito cadeias de caracteres com elementos como sinais positivos ou negativos e símbolos de ponto decimais. |
AllowLeadingWhite | O elemento ws no início de s . |
AllowTrailingWhite | O elemento ws no final de s . |
AllowLeadingSign | O elemento de sinal |
AllowTrailingSign | O elemento de sinal |
AllowParentheses | O sinal elemento na forma de parênteses que incluem o valor numérico. |
AllowThousands | O elemento ,. |
AllowCurrencySymbol | O elemento $. |
Currency | Todo. O parâmetro s não pode representar um número hexadecimal ou um número na notação exponencial. |
Float | O elemento ws no início ou no final de s , de sinal no início do s e no símbolo . . O parâmetro s também pode usar notação exponencial. |
Number | Os elementos ws , sign , , e . . |
Any | Todos os estilos, exceto s não podem representar um número hexadecimal. |
O parâmetro s
é analisado usando as informações de formatação em um objeto NumberFormatInfo inicializado para a cultura atual do sistema. Para obter mais informações, consulte CurrentInfo.
Um Decimal tem 29 dígitos de precisão. Se s
representar um número com mais de 29 dígitos, mas tiver uma parte fracionária e estiver dentro do intervalo de MaxValue e MinValue, o número será arredondado, não truncado, para 29 dígitos usando arredondamento para mais próximo.
Se um separador for encontrado no parâmetro s
durante uma operação de análise, styles
inclui os valores NumberStyles.AllowThousands e NumberStyles.AllowDecimalPoint, e a moeda ou número decimais aplicáveis e separadores de grupo são os mesmos, a operação de análise pressupõe que o separador seja um separador decimal em vez de um separador de grupo. Para obter mais informações sobre separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatore NumberGroupSeparator.
Confira também
Aplica-se a
Parse(String, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando as informações de formato específicas da cultura especificadas.
public:
static System::Decimal Parse(System::String ^ s, IFormatProvider ^ provider);
public:
static System::Decimal Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<System::Decimal>::Parse;
public static decimal Parse (string s, IFormatProvider provider);
public static decimal Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> decimal
Public Shared Function Parse (s As String, provider As IFormatProvider) As Decimal
Parâmetros
- s
- String
A representação de cadeia de caracteres do número a ser convertido.
- provider
- IFormatProvider
Um IFormatProvider que fornece informações de análise específicas da cultura sobre s
.
Retornos
O número de Decimal equivalente ao número contido em s
conforme especificado por provider
.
Implementações
Exceções
s
é null
.
s
não é do formato correto.
s
representa um número menor que Decimal.MinValue ou maior que Decimal.MaxValue.
Exemplos
O exemplo a seguir é o manipulador de eventos de clique de botão de um formulário da Web. Ele usa a matriz retornada pela propriedade HttpRequest.UserLanguages para determinar a localidade do usuário. Em seguida, cria uma instância de um objeto CultureInfo que corresponde a essa localidade. O objeto NumberFormatInfo que pertence a esse objeto CultureInfo é passado para o método Parse(String, IFormatProvider) para converter a entrada do usuário em um valor Decimal.
protected void OkToDecimal_Click(object sender, EventArgs e)
{
string locale;
decimal number;
CultureInfo culture;
// Return if string is empty
if (String.IsNullOrEmpty(this.inputNumber.Text))
return;
// Get locale of web request to determine possible format of number
if (Request.UserLanguages.Length == 0)
return;
locale = Request.UserLanguages[0];
if (String.IsNullOrEmpty(locale))
return;
// Instantiate CultureInfo object for the user's locale
culture = new CultureInfo(locale);
// Convert user input from a string to a number
try
{
number = Decimal.Parse(this.inputNumber.Text, culture.NumberFormat);
}
catch (FormatException)
{
return;
}
catch (Exception)
{
return;
}
// Output number to label on web form
this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToDecimal_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToDecimal.Click
Dim locale As String
Dim culture As CultureInfo
Dim number As Decimal
' Return if string is empty
If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub
' Get locale of web request to determine possible format of number
If Request.UserLanguages.Length = 0 Then Exit Sub
locale = Request.UserLanguages(0)
If String.IsNullOrEmpty(locale) Then Exit Sub
' Instantiate CultureInfo object for the user's locale
culture = New CultureInfo(locale)
' Convert user input from a string to a number
Try
number = Decimal.Parse(Me.inputNumber.Text, culture.NumberFormat)
Catch ex As FormatException
Exit Sub
Catch ex As Exception
Exit Sub
End Try
' Output number to label on web form
Me.outputNumber.Text = "Number is " & number.ToString()
End Sub
Comentários
Essa sobrecarga do método Parse(String, IFormatProvider) é comumente usada para converter texto que pode ser formatado de várias maneiras para um valor Decimal. 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 parâmetro s
contém um número do formulário:
[ws] [sign] [dígitos,]dígitos[.fractional-digits][ws]
Elementos em colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
ws | Espaço em branco opcional. |
assinar | Um sinal opcional. |
dígitos | Uma sequência de dígitos variando de 0 a 9. |
, | Um símbolo separador de milhares específico à cultura. |
. | Um símbolo de ponto decimal específico da cultura. |
de dígitos fracionários | Uma sequência de dígitos variando de 0 a 9. |
O parâmetro s
é interpretado usando o estilo NumberStyles.Number. Isso significa que o espaço em branco e milhares de separadores são permitidos, mas os símbolos de moeda não são. Para definir explicitamente os elementos (como símbolos de moeda, milhares de separadores e espaço em branco) que podem estar presentes em s
, use o método Decimal.Parse(String, NumberStyles, IFormatProvider).
O parâmetro provider
é uma implementação IFormatProvider, como um objeto NumberFormatInfo ou CultureInfo. O parâmetro provider
fornece informações específicas da cultura usadas na análise. Se provider
for null
, a cultura atual do thread será usada.
Um objeto Decimal tem 29 dígitos de precisão. Se s
representar um número com mais de 29 dígitos, mas tiver uma parte fracionária e estiver dentro do intervalo de MaxValue e MinValue, o número será arredondado, não truncado, para 29 dígitos usando arredondamento para mais próximo.
Se um separador for encontrado no parâmetro s
durante uma operação de análise, e a moeda ou o número decimal aplicável e separadores de grupo forem os mesmos, a operação de análise pressupõe que o separador seja um separador decimal em vez de um separador de grupo. Para obter mais informações sobre separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatore NumberGroupSeparator.
Confira também
Aplica-se a
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Analisa um intervalo de caracteres UTF-8 em um valor.
public static decimal Parse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Number, IFormatProvider? provider = default);
static member Parse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider -> decimal
Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.Number, Optional provider As IFormatProvider = Nothing) As Decimal
Parâmetros
- utf8Text
- ReadOnlySpan<Byte>
O intervalo de caracteres UTF-8 a serem analisados.
- style
- NumberStyles
Uma combinação bit a bit de estilos numéricos que podem estar presentes em utf8Text
.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura sobre utf8Text
.
Retornos
O resultado da análise de utf8Text
.
Implementações
Aplica-se a
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Converte a representação de intervalo de um número em seu Decimal equivalente usando o estilo especificado e o formato específico da cultura.
public static decimal Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Number, IFormatProvider? provider = default);
public static decimal Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Number, IFormatProvider provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> decimal
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Number, Optional provider As IFormatProvider = Nothing) As Decimal
Parâmetros
- s
- ReadOnlySpan<Char>
O intervalo que contém os caracteres que representam o número a ser convertido.
- style
- NumberStyles
Uma combinação bit a bit de valores NumberStyles que indica os elementos de estilo que podem estar presentes em s
. Um valor típico a ser especificado é Number.
- provider
- IFormatProvider
Um objeto IFormatProvider que fornece informações específicas da cultura sobre o formato de s
.
Retornos
O número Decimal equivalente ao número contido em s
conforme especificado por style
e provider
.
Implementações
Aplica-se a
Parse(String, NumberStyles, IFormatProvider)
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
- Origem:
- Decimal.cs
Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando o formato específico de estilo e cultura especificados.
public:
static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public:
static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<System::Decimal>::Parse;
public static decimal Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
public static decimal Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> decimal
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Decimal
Parâmetros
- s
- String
A representação de cadeia de caracteres do número a ser convertido.
- style
- NumberStyles
Uma combinação bit a bit de valores NumberStyles que indica os elementos de estilo que podem estar presentes em s
. Um valor típico a ser especificado é Number.
- provider
- IFormatProvider
Um objeto IFormatProvider que fornece informações específicas da cultura sobre o formato de s
.
Retornos
O número Decimal equivalente ao número contido em s
conforme especificado por style
e provider
.
Implementações
Exceções
s
não está no formato correto.
s
representa um número menor que Decimal.MinValue ou maior que Decimal.MaxValue.
s
é null
.
Exemplos
O exemplo a seguir usa uma variedade de parâmetros style
e provider
para analisar as representações de cadeia de caracteres de valores Decimal.
string value;
decimal number;
NumberStyles style;
CultureInfo provider;
// Parse string using " " as the thousands separator
// and "," as the decimal separator for fr-FR culture.
value = "892 694,12";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
provider = new CultureInfo("fr-FR");
number = Decimal.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '892 694,12' converted to 892694.12.
try
{
number = Decimal.Parse(value, style, CultureInfo.InvariantCulture);
Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
// Unable to parse '892 694,12'.
// Parse string using "$" as the currency symbol for en-GB and
// en-US cultures.
value = "$6,032.51";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
provider = new CultureInfo("en-GB");
try
{
number = Decimal.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
// Unable to parse '$6,032.51'.
provider = new CultureInfo("en-US");
number = Decimal.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
// '$6,032.51' converted to 6032.51.
// Parse string using " " as the thousands separator
// and "," as the decimal separator for fr-FR culture.
let value = "892 694,12"
let style = NumberStyles.AllowDecimalPoint ||| NumberStyles.AllowThousands
let provider = CultureInfo "fr-FR"
let number = Decimal.Parse(value, style, provider)
printfn $"'{value}' converted to {number}."
// Displays:
// '892 694,12' converted to 892694.12.
try
let number = Decimal.Parse(value, style, CultureInfo.InvariantCulture)
printfn $"'{value}' converted to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}'."
// Displays:
// Unable to parse '892 694,12'.
// Parse string using "$" as the currency symbol for en-GB and
// en-US cultures.
let value = "$6,032.51"
let style = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol
let provider = CultureInfo "en-GB"
try
let number = Decimal.Parse(value, style, provider)
printfn $"'{value}' converted to {number}."
with :? FormatException ->
printfn $"Unable to parse '{value}'."
// Displays:
// Unable to parse '$6,032.51'.
let provider = CultureInfo "en-US"
let number = Decimal.Parse(value, style, provider)
printfn $"'{value}' converted to {number}."
// Displays:
// '$6,032.51' converted to 6032.51.
Dim value As String
Dim number As Decimal
Dim style As NumberStyles
Dim provider As CultureInfo
' Parse string using " " as the thousands separator
' and "," as the decimal separator for fr-FR culture.
value = "892 694,12"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
provider = New CultureInfo("fr-FR")
number = Decimal.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '892 694,12' converted to 892694.12.
Try
number = Decimal.Parse(value, style, CultureInfo.InvariantCulture)
Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
' Unable to parse '892 694,12'.
' Parse string using "$" as the currency symbol for en-GB and
' en-US cultures.
value = "$6,032.51"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
provider = New CultureInfo("en-GB")
Try
number = Decimal.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
' Unable to parse '$6,032.51'.
provider = New CultureInfo("en-US")
number = Decimal.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
' '$6,032.51' converted to 6032.51.
Comentários
O parâmetro style
define o formato permitido do parâmetro s
para que a operação de análise seja bem-sucedida. Deve ser uma combinação de sinalizadores de bits da enumeração NumberStyles. Não há suporte para os seguintes membros NumberStyles:
Dependendo do valor de style
, o parâmetro s
pode incluir os seguintes elementos:
[ws] [$] [sign] [dígitos,]dígitos[.fractional-digits][e[sign]digits][ws]
Elementos em colchetes ([ e ]) são opcionais. A tabela a seguir descreve cada elemento.
Elemento | Descrição |
---|---|
$ | Um símbolo de moeda específico à cultura. Sua posição na cadeia de caracteres é definida pelas propriedades CurrencyNegativePattern e CurrencyPositivePattern do objeto NumberFormatInfo retornado pelo método GetFormat do parâmetro provider . O símbolo de moeda poderá aparecer em s se style incluir o sinalizador NumberStyles.AllowCurrencySymbol. |
ws | Espaço em branco opcional. O espaço em branco poderá aparecer no início do s se style incluir o sinalizador NumberStyles.AllowLeadingWhite e ele poderá aparecer no final do s se style incluir o sinalizador NumberStyles.AllowTrailingWhite. |
assinar | Um sinal opcional. O sinal poderá aparecer no início do s se style incluir o sinalizador de NumberStyles.AllowLeadingSign e ele poderá aparecer no final do s se style incluir o sinalizador NumberStyles.AllowTrailingSign. Parênteses podem ser usados em s para indicar um valor negativo se style incluir o sinalizador NumberStyles.AllowParentheses. |
dígitos | Uma sequência de dígitos variando de 0 a 9. |
, | Um símbolo separador de milhares específico à cultura. O separador de milhares da cultura definida por provider poderá aparecer em s se style incluir o sinalizador NumberStyles.AllowThousands. |
. | Um símbolo de ponto decimal específico da cultura. O símbolo de ponto decimal da cultura definida por provider poderá aparecer em s se style incluir o sinalizador NumberStyles.AllowDecimalPoint. |
de dígitos fracionários | Uma sequência de dígitos variando de 0 a 9. Dígitos fracionários só poderão aparecer em s se style incluir o sinalizador NumberStyles.AllowDecimalPoint. |
e | O caractere 'e' ou 'E', que indica que o valor é representado na notação exponencial. O parâmetro s pode representar um número na notação exponencial se style incluir o sinalizador NumberStyles.AllowExponent. |
Nota
Todos os caracteres NUL de terminação (U+0000) em s
são ignorados pela operação de análise, independentemente do valor do argumento style
.
Uma cadeia de caracteres somente com dígitos (que corresponde ao estilo None) sempre será analisada com êxito se estiver no intervalo do tipo Decimal. Os membros restantes NumberStyles controlam elementos que podem estar, mas não precisam estar presentes na cadeia de caracteres de entrada. A tabela a seguir indica como membros NumberStyles individuais afetam os elementos que podem estar presentes no s
.
Valor de NumberStyles | Elementos permitidos em s além de dígitos |
---|---|
None | O dígitos elemento somente. |
AllowDecimalPoint | O . e elementos de dígitos fracionários. |
AllowExponent | O parâmetro s também pode usar notação exponencial. Esse sinalizador dá suporte a valores no formulário dígitosdígitos E; sinalizadores adicionais são necessários para analisar com êxito cadeias de caracteres com elementos como sinais positivos ou negativos e símbolos de ponto decimais. |
AllowLeadingWhite | O elemento ws no início de s . |
AllowTrailingWhite | O elemento ws no final de s . |
AllowLeadingSign | O elemento de sinal |
AllowTrailingSign | O elemento de sinal |
AllowParentheses | O sinal elemento na forma de parênteses que incluem o valor numérico. |
AllowThousands | O elemento ,. |
AllowCurrencySymbol | O elemento $. |
Currency | Todo. O parâmetro s não pode representar um número hexadecimal ou um número na notação exponencial. |
Float | O elemento ws no início ou no final de s , assinar no início do s e no . símbolo. O parâmetro s também pode usar notação exponencial. |
Number | O ws , sign , ,e . elementos. |
Any | Todos os estilos, exceto s não podem representar um número hexadecimal. |
O parâmetro provider
é uma implementação IFormatProvider, como um objeto NumberFormatInfo ou CultureInfo. O parâmetro provider
fornece informações específicas da cultura usadas na análise. Se provider
for null
, a cultura atual do thread será usada.
Um objeto Decimal tem 29 dígitos de precisão. Se s
representar um número com mais de 29 dígitos, mas tiver uma parte fracionária e estiver dentro do intervalo de MaxValue e MinValue, o número será arredondado, não truncado, para 29 dígitos usando arredondamento para mais próximo.
Se um separador for encontrado no parâmetro s
durante uma operação de análise, e a moeda ou o número decimal aplicável e separadores de grupo forem os mesmos, a operação de análise pressupõe que o separador seja um separador decimal em vez de um separador de grupo. Para obter mais informações sobre separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatore NumberGroupSeparator.
Confira também
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários