Decimal.Parse Método

Definición

Convierte la representación en forma de cadena de un número en su Decimal equivalente.

Sobrecargas

Parse(String, NumberStyles, IFormatProvider)

Convierte la representación de cadena de un número en su Decimal equivalente utilizando el estilo y el formato específico de la referencia cultural que se hayan especificado.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Convierte la representación de intervalo de un número en su valor Decimal equivalente mediante el estilo y el formato específico de la referencia cultural que se hayan especificado.

Parse(String, IFormatProvider)

Convierte la representación de cadena de un número en su Decimal equivalente utilizando la información de formato específica de la referencia cultural especificada.

Parse(String, NumberStyles)

Convierte la representación de cadena de un número con un estilo especificado en su Decimal equivalente.

Parse(String)

Convierte la representación en forma de cadena de un número en su Decimal equivalente.

Parse(String, NumberStyles, IFormatProvider)

Convierte la representación de cadena de un número en su Decimal equivalente utilizando el estilo y el formato específico de la referencia cultural que se hayan especificado.

public:
 static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
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

Representación de cadena del número que va a convertirse.

style
NumberStyles

Combinación bit a bit de valores NumberStyles que indica los elementos de estilo que pueden estar presentes en s. Un valor que se especifica de forma habitual es Number.

provider
IFormatProvider

Objeto IFormatProvider que aporta información específica de la referencia cultural acerca del formato de s.

Devoluciones

Decimal

Número Decimal equivalente al número contenido en s, tal y como especifican style y provider.

Excepciones

s no tiene el formato correcto.

s representa un número menor que MinValue o mayor que MaxValue.

style no es un valor NumberStyles.

O bien

style es el valor AllowHexSpecifier.

Ejemplos

En el ejemplo siguiente se usan diversos parámetros style y para analizar las provider representaciones de cadena de Decimal valores.

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

Comentarios

El style parámetro define el formato permitido del parámetro para que la operación de análisis se pueda realizar s correctamente. Debe ser una combinación de marcas de bits de la NumberStyles enumeración . No se NumberStyles admiten los miembros siguientes:

Dependiendo del valor de style , el parámetro puede incluir los siguientes s elementos:

[ws] [$] [sign] [digits,]digits[.fractional-digits][e[sign]digits][ws]

Los elementos de los corchetes ([ y ]) son opcionales. En esta tabla se describe cada elemento.

Elemento Descripción
$ Símbolo de moneda específico de la referencia cultural. Su posición en la cadena se define mediante las CurrencyNegativePattern propiedades y del objeto devuelto por el método del parámetro CurrencyPositivePattern NumberFormatInfo GetFormat provider . El símbolo de moneda puede aparecer en s si incluye la marca style NumberStyles.AllowCurrencySymbol .
ws Espacio en blanco opcional. El espacio en blanco puede aparecer al principio de si incluye la marca y puede aparecer al final de s si incluye la marca style NumberStyles.AllowLeadingWhite s style NumberStyles.AllowTrailingWhite .
sign Un signo opcional. El signo puede aparecer al principio de si incluye la marca y puede aparecer al final de s si incluye la marca style NumberStyles.AllowLeadingSign s style NumberStyles.AllowTrailingSign . Los paréntesis se pueden usar en s para indicar un valor negativo si incluye la marca style NumberStyles.AllowParentheses .
dígitos Secuencia de dígitos que van de 0 a 9.
, Símbolo separador de miles específico de la referencia cultural. El separador de miles de la referencia cultural definida provider por puede aparecer en si incluye la marca s style NumberStyles.AllowThousands .
. Símbolo de separador decimal específico de la referencia cultural. El símbolo de separador decimal de la referencia cultural definida por provider puede aparecer en si incluye la marca s style NumberStyles.AllowDecimalPoint .
dígitos fraccionarios Secuencia de dígitos que van de 0 a 9. Los dígitos fraccionarios solo s pueden aparecer en si incluye la marca style NumberStyles.AllowDecimalPoint .
e Carácter 'e' o 'E', que indica que el valor se representa en notación exponencial. El s parámetro puede representar un número en notación exponencial si incluye la marca style NumberStyles.AllowExponent .

Nota

La operación de análisis omite los caracteres NUL (U+0000) de terminación, independientemente del valor s del style argumento.

Una cadena solo con dígitos (que corresponde al estilo) siempre analiza correctamente si se encuentra en el None intervalo del Decimal tipo. Los miembros restantes controlan los elementos que pueden estar presentes en la cadena de entrada, pero que no NumberStyles son necesarios. En la tabla siguiente se indica cómo afectan los miembros individuales NumberStyles a los elementos que pueden estar presentes en s .

Valor NumberStyles Elementos permitidos en , además de dígitos
None Solo el elemento digits.
AllowDecimalPoint El elemento de lenguaje . y elementos de dígitos fraccionarios.
AllowExponent El s parámetro también puede usar la notación exponencial. Esta marca admite valores con los dígitos del formulario Dígitos E ; Se necesitan marcas adicionales para analizar correctamente cadenas con elementos como signos positivos o negativos y símbolos de separador decimal.
AllowLeadingWhite Elemento ws al principio de s .
AllowTrailingWhite Elemento ws al final de s .
AllowLeadingSign Elemento de signo al principio de s .
AllowTrailingSign Elemento de signo al final de s .
AllowParentheses Elemento de signo en forma de paréntesis que incluye el valor numérico.
AllowThousands Elemento , .
AllowCurrencySymbol Elemento $ .
Currency Todos. El s parámetro no puede representar un número hexadecimal o un número en notación exponencial.
Float Elemento ws al principio o al final de s , signo al principio de s y . Símbolo. El s parámetro también puede usar la notación exponencial.
Number , ws sign , , y . .
Any Todos los estilos, excepto s no pueden representar un número hexadecimal.

El provider parámetro es una IFormatProvider implementación, como un objeto o NumberFormatInfo CultureInfo . El provider parámetro proporciona información específica de la referencia cultural que se usa en el análisis. Si provider es null, se usa la referencia cultural actual del subproceso.

Un Decimal objeto tiene 29 dígitos de precisión. Si representa un número que tiene más de 29 dígitos, pero tiene una parte fraccionera y está dentro del intervalo de y , el número se redondea, no s trunca, a 29 dígitos mediante redondeo al más MaxValue MinValue cercano.

Si se encuentra un separador en el parámetro durante una operación de análisis y los separadores decimales y de grupo de moneda o número aplicables son los mismos, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de s grupo. Para obtener más información sobre los separadores, CurrencyDecimalSeparator vea , , y NumberDecimalSeparator CurrencyGroupSeparator NumberGroupSeparator .

Consulte también

Se aplica a

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Convierte la representación de intervalo de un número en su valor Decimal equivalente mediante el estilo y el formato específico de la referencia cultural que se hayan especificado.

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>

El intervalo que contiene los caracteres que representan el número que se va a convertir.

style
NumberStyles

Combinación bit a bit de valores NumberStyles que indica los elementos de estilo que pueden estar presentes en s. Un valor que se especifica de forma habitual es Number.

provider
IFormatProvider

Objeto IFormatProvider que aporta información específica de la referencia cultural acerca del formato de s.

Devoluciones

Decimal

Número Decimal equivalente al número contenido en s, tal y como especifican style y provider.

Se aplica a

Parse(String, IFormatProvider)

Convierte la representación de cadena de un número en su Decimal equivalente utilizando la información de formato específica de la referencia cultural especificada.

public:
 static System::Decimal Parse(System::String ^ s, IFormatProvider ^ provider);
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

Representación de cadena del número que va a convertirse.

provider
IFormatProvider

IFormatProvider que aporta información de análisis específica de la referencia cultural sobre s.

Devoluciones

Decimal

Número Decimal equivalente al número contenido en s, tal y como especifica provider.

Excepciones

s no tiene el formato correcto.

s representa un número menor que MinValue o mayor que MaxValue.

Ejemplos

El ejemplo siguiente es el controlador de eventos click de botón de un formulario web. Usa la matriz devuelta por la HttpRequest.UserLanguages propiedad para determinar la configuración regional del usuario. A continuación, crea una instancia CultureInfo de un objeto que corresponde a esa configuración regional. A continuación, el objeto que pertenece a ese objeto se pasa al método para convertir la entrada NumberFormatInfo del usuario en un valor CultureInfo Parse(String, IFormatProvider) 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

Comentarios

Esta sobrecarga del método se usa normalmente para convertir texto al que se puede dar formato de varias maneras Parse(String, IFormatProvider) en un Decimal valor. Por ejemplo, se puede usar para convertir el texto escrito por un usuario en un cuadro de texto HTML en un valor numérico.

El s parámetro contiene un número del formulario:

[ws] [sign] [digits,]digits[.fractional-digits][ws]

Los elementos de los corchetes ([ y ]) son opcionales. En esta tabla se describe cada elemento.

Elemento Descripción
ws Espacio en blanco opcional.
sign Un signo opcional.
dígitos Secuencia de dígitos que van de 0 a 9.
, Símbolo separador de miles específico de la referencia cultural.
. Símbolo de separador decimal específico de la referencia cultural.
dígitos fraccionarios Secuencia de dígitos que van de 0 a 9.

El s parámetro se interpreta mediante el estilo NumberStyles.Number . Esto significa que se permiten espacios en blanco y separadores de miles, pero no los símbolos de moneda. Para definir explícitamente los elementos (como símbolos de moneda, separadores de miles y espacios en blanco) que pueden estar presentes en s , use el método Decimal.Parse(String, NumberStyles, IFormatProvider) .

El provider parámetro es una IFormatProvider implementación, como un objeto o NumberFormatInfo CultureInfo . El provider parámetro proporciona información específica de la referencia cultural utilizada en el análisis. Si provider es null, se usa la referencia cultural actual del subproceso.

Un Decimal objeto tiene 29 dígitos de precisión. Si representa un número que tiene más de 29 dígitos, pero tiene una parte fraccionera y está dentro del intervalo de y , el número se redondea, no s trunca, a 29 dígitos mediante redondeo al más MaxValue MinValue cercano.

Si se encuentra un separador en el parámetro durante una operación de análisis y los separadores decimales y de grupo de moneda o número aplicables son los mismos, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de s grupo. Para obtener más información sobre los separadores, CurrencyDecimalSeparator vea , , y NumberDecimalSeparator CurrencyGroupSeparator NumberGroupSeparator .

Consulte también

Se aplica a

Parse(String, NumberStyles)

Convierte la representación de cadena de un número con un estilo especificado en su 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

Representación de cadena del número que va a convertirse.

style
NumberStyles

Combinación bit a bit de valores NumberStyles que indica los elementos de estilo que pueden estar presentes en s. Un valor que se especifica de forma habitual es Number.

Devoluciones

Decimal

Número Decimal equivalente al número contenido en s, tal y como especifica style.

Excepciones

style no es un valor NumberStyles.

O bien

style es el valor AllowHexSpecifier.

s no tiene el formato correcto.

s representa un número menor que MinValue o mayor que MaxValue.

Ejemplos

En el ejemplo de código siguiente se Parse(String, NumberStyles) usa el método para analizar las representaciones de cadena de valores mediante la referencia cultural Decimal 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.
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.

Comentarios

El parámetro define los elementos de estilo (como separadores de miles, espacios en blanco y símbolos de moneda) que se permiten en el parámetro para que la operación de análisis se haga style s correctamente. Debe ser una combinación de marcas de bits de la NumberStyles enumeración . No se NumberStyles admiten los miembros siguientes:

Dependiendo del valor de style , el parámetro puede incluir los siguientes s elementos:

[ws] [$] [sign] [digits,]digits[.fractional-digits][e[sign]digits][ws]

Los elementos de los corchetes ([ y ]) son opcionales. En esta tabla se describe cada elemento.

Elemento Descripción
ws Espacio en blanco opcional. El espacio en blanco puede aparecer al principio de si incluye la marca y puede aparecer al final de s si incluye la marca style NumberStyles.AllowLeadingWhite s style NumberStyles.AllowTrailingWhite .
$ Símbolo de moneda específico de la referencia cultural. Su posición en la cadena se define mediante las NumberFormatInfo.CurrencyNegativePattern propiedades y de la referencia cultural NumberFormatInfo.CurrencyPositivePattern actual. El símbolo de moneda de la referencia cultural actual puede aparecer en s si incluye la marca style NumberStyles.AllowCurrencySymbol .
sign Un signo opcional. El signo puede aparecer al principio de si incluye la marca y puede aparecer al final de s si incluye la marca style NumberStyles.AllowLeadingSign s style NumberStyles.AllowTrailingSign . Los paréntesis se pueden usar en s para indicar un valor negativo si incluye la marca style NumberStyles.AllowParentheses .
dígitos Secuencia de dígitos que van de 0 a 9.
, Símbolo separador de miles específico de la referencia cultural. El separador de miles de la referencia cultural actual puede aparecer en s si incluye la marca style NumberStyles.AllowThousands .
. Símbolo de separador decimal específico de la referencia cultural. El símbolo de separador decimal de la referencia cultural actual puede aparecer en s si incluye la marca style NumberStyles.AllowDecimalPoint .
dígitos fraccionarios Secuencia de dígitos que van de 0 a 9. Los dígitos fraccionarios solo s pueden aparecer en si incluye la marca style NumberStyles.AllowDecimalPoint .
e Carácter 'e' o 'E', que indica que el valor se representa en notación exponencial. El s parámetro puede representar un número en notación exponencial si incluye la marca style NumberStyles.AllowExponent .

Nota

La operación de análisis omite los caracteres NUL (U+0000) de terminación, independientemente del valor s del style argumento.

Una cadena solo con dígitos (que corresponde al estilo) siempre analiza correctamente si se encuentra en el None intervalo del Decimal tipo. Los miembros restantes controlan los elementos que pueden estar presentes en la cadena de entrada, pero que no NumberStyles son necesarios. En la tabla siguiente se indica cómo afectan los miembros individuales NumberStyles a los elementos que pueden estar presentes en s .

Valor NumberStyles Elementos permitidos en , además de dígitos
None Solo el elemento digits.
AllowDecimalPoint El elemento de lenguaje . y elementos de dígitos fraccionarios.
AllowExponent El s parámetro también puede usar la notación exponencial. Esta marca admite valores con los dígitos del formulario Dígitos E ; Se necesitan marcas adicionales para analizar correctamente cadenas con elementos como signos positivos o negativos y símbolos de separador decimal.
AllowLeadingWhite Elemento ws al principio de s .
AllowTrailingWhite Elemento ws al final de s .
AllowLeadingSign Elemento de signo al principio de s .
AllowTrailingSign Elemento de signo al final de s .
AllowParentheses Elemento de signo en forma de paréntesis que incluye el valor numérico.
AllowThousands Elemento , .
AllowCurrencySymbol Elemento $ .
Currency Todos. El s parámetro no puede representar un número hexadecimal o un número en notación exponencial.
Float Elemento ws al principio o al final de s , signo al principio de y s el . símbolo. El s parámetro también puede usar la notación exponencial.
Number Los ws elementos , y sign , . .
Any Todos los estilos, excepto s no pueden representar un número hexadecimal.

El s parámetro se analiza utilizando la información de formato de un objeto NumberFormatInfo inicializado para la referencia cultural actual del sistema. Para obtener más información, vea CurrentInfo.

Un Decimal tiene 29 dígitos de precisión. Si representa un número que tiene más de 29 dígitos, pero tiene una parte fraccionera y está dentro del intervalo de y , el número se redondea, no s trunca, a 29 dígitos mediante redondeo al más MaxValue MinValue cercano.

Si se encuentra un separador en el parámetro durante una operación de análisis, incluye los valores y , y los separadores decimales y de grupo de moneda o número aplicables son los mismos, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de s styles NumberStyles.AllowThousands NumberStyles.AllowDecimalPoint grupo. Para obtener más información sobre los separadores, CurrencyDecimalSeparator vea , , y NumberDecimalSeparator CurrencyGroupSeparator NumberGroupSeparator .

Consulte también

Se aplica a

Parse(String)

Convierte la representación en forma de cadena de un número en su 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

Representación de cadena del número que va a convertirse.

Devoluciones

Decimal

Equivalente al número que se incluye en s.

Excepciones

s no tiene el formato correcto.

s representa un número menor que MinValue o mayor que MaxValue.

Ejemplos

En el ejemplo de código siguiente se usa Parse(String) el método para analizar representaciones de cadena de Decimal valores.

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'.
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'.

Comentarios

El s parámetro contiene un número del formulario:

[ws] [sign] [digits,]digits[.fractional-digits][ws]

Los elementos de los corchetes ([ y ]) son opcionales. En esta tabla se describe cada elemento.

Elemento Descripción
ws Espacio en blanco opcional.
sign Un signo opcional.
dígitos Secuencia de dígitos que van de 0 a 9.
, Símbolo separador de miles específico de la referencia cultural.
. Símbolo de separador decimal específico de la referencia cultural.
dígitos fraccionarios Secuencia de dígitos que van de 0 a 9.

El s parámetro se interpreta mediante el estilo NumberStyles.Number . Esto significa que se permiten espacios en blanco y separadores de miles, pero no los símbolos de moneda. Para definir explícitamente los elementos (como símbolos de moneda, separadores de miles y espacios en blanco) que pueden estar presentes en s , use el método o Decimal.Parse(String, NumberStyles) Decimal.Parse(String, NumberStyles, IFormatProvider) .

El s parámetro se analiza utilizando la información de formato de un NumberFormatInfo inicializado para la referencia cultural actual del sistema. Para obtener más información, vea CurrentInfo. Para analizar una cadena con la información de formato de otra referencia cultural, use el Decimal.Parse(String, IFormatProvider) método Decimal.Parse(String, NumberStyles, IFormatProvider) o .

Si es necesario, el valor de s se redondea mediante el redondeo al más cercano.

Un Decimal tiene 29 dígitos de precisión. Si representa un número que tiene más de 29 dígitos, pero tiene una parte fraccionera y está dentro del intervalo de y , el número se redondea, no s trunca, a 29 dígitos mediante redondeo al más MaxValue MinValue cercano.

Si durante una operación de análisis se encuentra un separador en el parámetro y los separadores decimales y de grupo de moneda o número aplicables son los mismos, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de s grupo. Para obtener más información sobre los separadores, CurrencyDecimalSeparator vea , , y NumberDecimalSeparator CurrencyGroupSeparator NumberGroupSeparator .

Consulte también

Se aplica a