Double.TryParse Double.TryParse Double.TryParse Double.TryParse Method

Definición

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión doble equivalente.Converts the string representation of a number to its double-precision floating-point number equivalent. Un valor devuelto indica si la conversión se realizó correctamente o si se produjeron errores.A return value indicates whether the conversion succeeded or failed.

Sobrecargas

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double)
TryParse(String, Double) TryParse(String, Double) TryParse(String, Double) TryParse(String, Double)

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión doble equivalente.Converts the string representation of a number to its double-precision floating-point number equivalent. Un valor devuelto indica si la conversión se realizó correctamente o si se produjeron errores.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, Double) TryParse(ReadOnlySpan<Char>, Double) TryParse(ReadOnlySpan<Char>, Double) TryParse(ReadOnlySpan<Char>, Double)
TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double)

Convierte la representación en forma de cadena de un número con un estilo y un formato específico de la referencia cultural especificados en el número de punto flotante de precisión doble equivalente.Converts the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Un valor devuelto indica si la conversión se realizó correctamente o si se produjeron errores.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double)

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

Parámetros

Devoluciones

TryParse(String, Double) TryParse(String, Double) TryParse(String, Double) TryParse(String, Double)

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión doble equivalente.Converts the string representation of a number to its double-precision floating-point number equivalent. Un valor devuelto indica si la conversión se realizó correctamente o si se produjeron errores.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] double % result);
public static bool TryParse (string s, out double result);
static member TryParse : string *  -> bool
Public Shared Function TryParse (s As String, ByRef result As Double) As Boolean

Parámetros

s
String String String String

Cadena que contiene un número que se va a convertir.A string containing a number to convert.

result
Double Double Double Double

Cuando el resultado que devuelve este método contiene el número de punto flotante de precisión doble equivalente al parámetro s, si la conversión tuvo éxito o cero si falló.When this method returns, contains the double-precision floating-point number equivalent of the s parameter, if the conversion succeeded, or zero if the conversion failed. La conversión no finaliza correctamente si el parámetro s es null o Empty, no es un número con formato válido o representa un número menor que MinValue o mayor que MaxValue.The conversion fails if the s parameter is null or Empty, is not a number in a valid format, or represents a number less than MinValue or greater than MaxValue. Este parámetro se pasa sin inicializar; cualquier valor proporcionado originalmente en result se sobrescribirá.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Devoluciones

true si s se convirtió correctamente; en caso contrario, false.true if s was converted successfully; otherwise, false.

Ejemplos

En el ejemplo siguiente se usa el TryParse(String, Double) método para convertir las representaciones de cadena de valores numéricos para Double valores.The following example uses the TryParse(String, Double) method to convert the string representations of numeric values to Double values. Se supone que en-US es la referencia cultural actual.It assumes that en-US is the current culture.

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { "1,643.57", "$1,643.57", "-1.643e6", 
                          "-168934617882109132", "123AE6", 
                          null, String.Empty, "ABCDEF" };
      double number;
      
      foreach (var value in values) {
         if (Double.TryParse(value, out number)) 
            Console.WriteLine("'{0}' --> {1}", value, number);
         else
            Console.WriteLine("Unable to parse '{0}'.", value);      
      }   
   }
}
// The example displays the following output:
//       '1,643.57' --> 1643.57
//       Unable to parse '$1,643.57'.
//       '-1.643e6' --> -1643000
//       '-168934617882109132' --> -1.68934617882109E+17
//       Unable to parse '123AE6'.
//       Unable to parse ''.
//       Unable to parse ''.
//       Unable to parse 'ABCDEF'.
Module Example
   Public Sub Main()
      Dim values() As String = { "1,643.57", "$1,643.57", "-1.643e6", 
                                "-168934617882109132", "123AE6", 
                                Nothing, String.Empty, "ABCDEF" }
      Dim number As Double
      
      For Each value In values
         If Double.TryParse(value, number) Then
            Console.WriteLine("'{0}' --> {1}", value, number)
         Else
            Console.WriteLine("Unable to parse '{0}'.", value)      
         End If   
      Next   
   End Sub
End Module
' The example displays the following output:
'       '1,643.57' --> 1643.57
'       Unable to parse '$1,643.57'.
'       '-1.643e6' --> -1643000
'       '-168934617882109132' --> -1.68934617882109E+17
'       Unable to parse '123AE6'.
'       Unable to parse ''.
'       Unable to parse ''.
'       Unable to parse 'ABCDEF'.

Comentarios

Esta sobrecarga difiere el Double.Parse(String) método devolviendo un valor booleano que indica si la operación de análisis se realizó correctamente en lugar de devolver el valor numérico analizado.This overload differs from the Double.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. Elimina la necesidad de usar el control de excepciones para probar una FormatException en caso de que s no es válido y no puede analizarse correctamente.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.

El s parámetro puede contener la referencia cultural actual NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol (la comparación de cadenas distingue mayúsculas de minúsculas), o una cadena del formulario:The s parameter can contain the current culture's NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol (the string comparison is case-sensitive), or a string of the form:

[ws][sign][integral-digits,]integral-digits[.[fractional-digits]][e[sign]exponential-digits][ws][ws][sign][integral-digits,]integral-digits[.[fractional-digits]][e[sign]exponential-digits][ws]

Los elementos entre corchetes son opcionales.Elements in square brackets are optional. En esta tabla se describe cada elemento.The following table describes each element.

ElementoElement DescripciónDescription
wsws Una serie de caracteres de espacio en blanco.A series of white-space characters.
signsign Un signo negativo o un símbolo de signo positivo.A negative sign or positive sign symbol.
integral-digitsintegral-digits Una serie de caracteres numéricos comprendidos entre 0 y 9 que especifican la parte entera del número.A series of numeric characters ranging from 0 to 9 that specify the integral part of the number. Dígitos enteros pueden estar ausentes si hay dígitos fraccionarios.Integral-digits can be absent if there are fractional-digits.
,, Un símbolo de separador de grupo específicas de referencias culturales.A culture-specific group separator symbol.
.. Un símbolo de separador de decimales de referencia cultural específica.A culture-specific decimal point symbol.
fractional-digitsfractional-digits Una serie de caracteres numéricos comprendidos entre 0 y 9 que especifican la parte fraccionaria del número.A series of numeric characters ranging from 0 to 9 that specify the fractional part of the number.
EE Un letra mayúscula o minúscula carácter "e", que indica una notación exponencial (científica).An uppercase or lowercase character 'e', that indicates exponential (scientific) notation.
exponential-digitsexponential-digits Una serie de caracteres numéricos comprendidos entre 0 y 9 que especifican a un exponente.A series of numeric characters ranging from 0 to 9 that specify an exponent.

Para obtener más información acerca de formatos numéricos, vea aplicar formato a tipos.For more information about numeric formats, see Formatting Types.

El s parámetro se interpreta usando una combinación de la NumberStyles.Float y NumberStyles.AllowThousands marcas.The s parameter is interpreted by using a combination of the NumberStyles.Float and NumberStyles.AllowThousands flags. Esto significa que ese espacio en blanco y miles se permiten separadores pero no símbolos de moneda.This means that white space and thousands separators are allowed but currency symbols are not. Para definir explícitamente los elementos (como símbolos de moneda, miles separadores y espacios en blanco) que pueden estar presentes en s, utilice el Double.TryParse(String, NumberStyles, IFormatProvider, Double) sobrecarga del método.To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method overload.

El s parámetro se analiza utilizando la información de formato en un NumberFormatInfo objeto que se inicializa para la referencia cultural actual del sistema.The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Para obtener más información, vea NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo. Para analizar una cadena utilizando la información de algún otro formato especifica la referencia cultural, use el Double.TryParse(String, NumberStyles, IFormatProvider, Double) sobrecarga del método.To parse a string using the formatting information of some other specified culture, use the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method overload.

Normalmente, si se pasa el Double.TryParse método una cadena que se crea mediante una llamada a la Double.ToString método, el original Double se devuelve el valor.Ordinarily, if you pass the Double.TryParse method a string that is created by calling the Double.ToString method, the original Double value is returned. Sin embargo, debido a una pérdida de precisión, los valores pueden no ser iguales.However, because of a loss of precision, the values may not be equal. Además, al intentar analizar la representación de cadena MinValue o MaxValue produce una OverflowException, tal y como se muestra en el ejemplo siguiente.In addition, attempting to parse the string representation of either MinValue or MaxValue throws an OverflowException, as the following example illustrates.

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;
      
      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.", 
                           value);
      
      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.            
Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.            

Si se encuentra un separador en la s parámetro durante una operación de análisis y los separadores decimales y grupos son iguales, la operación de análisis supone que se trata de un separador decimal en lugar de un separador de grupo.If a separator is encountered in the s parameter during a parse operation, and the decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. Para obtener más información acerca de los separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, y NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Consulte también:

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

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

Parámetros

Devoluciones

TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double) TryParse(String, NumberStyles, IFormatProvider, Double)

Convierte la representación en forma de cadena de un número con un estilo y un formato específico de la referencia cultural especificados en el número de punto flotante de precisión doble equivalente.Converts the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Un valor devuelto indica si la conversión se realizó correctamente o si se produjeron errores.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] double % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out double result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider *  -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Double) As Boolean

Parámetros

s
String String String String

Cadena que contiene un número que se va a convertir.A string containing a number to convert.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Combinación bit a bit de valores NumberStyles que indica el formato permitido de s.A bitwise combination of NumberStyles values that indicates the permitted format of s. Un valor que se especifica de forma habitual es Float combinado con AllowThousands.A typical value to specify is Float combined with AllowThousands.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Un IFormatProvider que proporciona información de formato específica de la referencia cultural acerca de s.An IFormatProvider that supplies culture-specific formatting information about s.

result
Double Double Double Double

Cuando el resultado que devuelve este método contiene el número de punto flotante de precisión doble equivalente al valor numérico o al símbolo contenido en s, si la conversión tuvo éxito o cero si falló.When this method returns, contains a double-precision floating-point number equivalent of the numeric value or symbol contained in s, if the conversion succeeded, or zero if the conversion failed. Se produce un error en la conversión si el parámetro s es null o Empty, no está en un formato compatible con style, representa un número menor que MinValue o mayor que MaxValue, o bien si style no es una combinación válida de constantes enumeradas de NumberStyles.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, represents a number less than MinValue or greater than MaxValue, or if style is not a valid combination of NumberStyles enumerated constants. Este parámetro se pasa sin inicializar; cualquier valor proporcionado originalmente en result se sobrescribirá.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Devoluciones

true si s se convirtió correctamente; en caso contrario, false.true if s was converted successfully; otherwise, false.

Excepciones

style no es un valor NumberStyles.style is not a NumberStyles value.

O bien-or- style incluye el valor AllowHexSpecifier style includes the AllowHexSpecifier value.

Ejemplos

En el ejemplo siguiente se muestra el uso de la Double.TryParse(String, NumberStyles, IFormatProvider, Double) método para analizar la representación de cadena de números que tienen un estilo determinado y se da formato usando las convenciones de una referencia cultural determinada.The following example demonstrates the use of the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method to parse the string representation of numbers that have a particular style and are formatted using the conventions of a particular culture.

string value;
NumberStyles style;
CultureInfo culture;
double number;

// Parse currency value using en-GB culture.
value = "�1,097.63";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
culture = CultureInfo.CreateSpecificCulture("en-GB");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays: 
//       Converted '�1,097.63' to 1097.63.

value = "1345,978";
style = NumberStyles.AllowDecimalPoint;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '1345,978' to 1345.978.

value = "1.345,978";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
culture = CultureInfo.CreateSpecificCulture("es-ES");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays: 
//       Converted '1.345,978' to 1345.978.

value = "1 345,978";
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Unable to convert '1 345,978'.
Dim value As String
Dim style As NumberStyles
Dim culture As CultureInfo
Dim number As Double

' Parse currency value using en-GB culture.
value = "�1,097.63"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
culture = CultureInfo.CreateSpecificCulture("en-GB")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '�1,097.63' to 1097.63.

value = "1345,978"
style = NumberStyles.AllowDecimalPoint
culture = CultureInfo.CreateSpecificCulture("fr-FR")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Converted '1345,978' to 1345.978.

value = "1.345,978"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
culture = CultureInfo.CreateSpecificCulture("es-ES")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '1.345,978' to 1345.978.

value = "1 345,978"
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Unable to convert '1 345,978'.

Comentarios

El TryParse método es similar a la Parse(String, NumberStyles, IFormatProvider) método, salvo que este método no produce una excepción si se produce un error en la conversión.The TryParse method is like the Parse(String, NumberStyles, IFormatProvider) method, except this method does not throw an exception if the conversion fails. Si la conversión se realiza correctamente, el valor devuelto es true y result parámetro se establece en el resultado de la conversión.If the conversion succeeds, the return value is true and the result parameter is set to the outcome of the conversion. Si se produce un error en la conversión, el valor devuelto es false y result parámetro se establece en cero.If the conversion fails, the return value is false and the result parameter is set to zero. Esto elimina la necesidad de usar el control de excepciones para probar una FormatException en caso de que s no es válido y no puede analizarse correctamente.This eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

El style parámetro define el formato permitido de la s parámetro para la operación de análisis se realice correctamente.The style parameter defines the allowable format of the s parameter for the parse operation to succeed. Debe ser una combinación de marcas de bits de la NumberStyles enumeración.It must be a combination of bit flags from the NumberStyles enumeration. La siguiente NumberStyles miembros no son compatibles:The following NumberStyles members are not supported:

El s parámetro puede contener NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, o NumberFormatInfo.NaNSymbol para la referencia cultural indicada por provider.The s parameter can contain NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, or NumberFormatInfo.NaNSymbol for the culture indicated by provider. Además, dependiendo del valor de style, el s parámetro puede incluir los siguientes elementos:In addition, depending on the value of style, the s parameter may include the following elements:

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

Los elementos de los corchetes ([ y ]) son opcionales.Elements in square brackets ([ and ]) are optional. En esta tabla se describe cada elemento.The following table describes each element.

ElementoElement DescripciónDescription
wsws Espacio en blanco opcional.Optional white space. Pueden aparecer espacios en blanco al principio de s si style incluye la NumberStyles.AllowLeadingWhite marca.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag. Puede aparecer al final de s si style incluye la NumberStyles.AllowTrailingWhite marca.It can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Un símbolo de moneda de la referencia cultural específica.A culture-specific currency symbol. Su posición en la cadena viene definida por el NumberFormatInfo.CurrencyNegativePattern o NumberFormatInfo.CurrencyPositivePattern propiedades de la NumberFormatInfo objeto devuelto por la IFormatProvider.GetFormat método de la provider parámetro.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern or NumberFormatInfo.CurrencyPositivePattern properties of the NumberFormatInfo object returned by the IFormatProvider.GetFormat method of the provider parameter. Puede aparecer el símbolo de moneda en s si style incluye la NumberStyles.AllowCurrencySymbol marca.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Un signo opcional.An optional sign. El inicio de sesión puede aparecer al principio de s si style incluye la NumberStyles.AllowLeadingSign marca y puede aparecer al final de s si style incluye la NumberStyles.AllowTrailingSign marca.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Se pueden utilizar paréntesis en s para indicar un valor negativo si style incluye la NumberStyles.AllowParentheses marca.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
integral-digitsintegral-digits Una serie de dígitos comprendidos del 0 al 9 que especifican la parte entera del número.A series of digits ranging from 0 to 9 that specify the integral part of the number. Dígitos enteros pueden estar ausentes si hay dígitos fraccionarios.Integral-digits can be absent if there are fractional-digits.
,, Específicas de referencias culturales miles símbolo de separador.A culture-specific thousands separator symbol. Miles de la referencia cultural actual separador símbolo puede aparecer en s si style incluye la NumberStyles.AllowThousands marca.The current culture's thousands separator symbol can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Un símbolo de separador de decimales de referencia cultural específica.A culture-specific decimal point symbol. Símbolo de separador decimal de la referencia cultural actual puede aparecer en s si style incluye la NumberStyles.AllowDecimalPoint marca.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional-digitsfractional-digits Una serie de dígitos comprendidos del 0 al 9 que especifican la parte fraccionaria del número.A series of digits ranging from 0 to 9 that specify the fractional part of the number. Pueden aparecer dígitos fraccionarios en s si style incluye la NumberStyles.AllowDecimalPoint marca.Fractional digits can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
ee El carácter e o E, que indica que s puede representar un número mediante notación exponencial.The e or E character, which indicates that s can represent a number using exponential notation. El s parámetro puede representar un número en notación exponencial si el estilo incluye la NumberStyles.AllowExponent marca.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential-digitsexponential-digits Una serie de dígitos comprendidos del 0 al 9 que especifican a un exponente.A series of digits ranging from 0 to 9 that specify an exponent.

Nota

Terminación NUL (u+0000) caracteres en s son ignoradas por la operación de análisis, independientemente del valor de la style argumento.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Una cadena formada únicamente por dígitos (que corresponde a la NumberStyles.None estilo) siempre se analiza correctamente.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. Los restantes System.Globalization.NumberStyles miembros controlan los elementos que pueden ser, pero no tienen que estar presentes en la cadena de entrada.The remaining System.Globalization.NumberStyles members control elements that may be but are not required to be present in the input string. La tabla siguiente se indica cómo individuales NumberStyles marcas afectan a los elementos que pueden estar presentes en s.The following table indicates how individual NumberStyles flags affect the elements that may be present in s.

Valor NumberStylesNumberStyles value Elementos permitidos en s además de dígitosElements permitted in s in addition to digits
None El dígitos enteros sólo elemento.The integral-digits element only.
AllowDecimalPoint El elemento de lenguaje .The . y dígitos fraccionarios elementos.and fractional-digits elements.
AllowExponent El s parámetro también puede utilizar la notación exponencial.The s parameter can also use exponential notation. Este marcador por sí solo admite valores en el formulario dígitos enterosEdígitos exponenciales; adicionales se necesitan los marcadores para analizar correctamente cadenas en notación exponencial con esos elementos como signos positivos o negativos y los símbolos de separador decimal.This flag by itself supports values in the form integral-digitsEexponential-digits; additional flags are needed to successfully parse strings in exponential notation with such elements as positive or negative signs and decimal point symbols.
AllowLeadingWhite El ws elemento situado al principio de s.The ws element at the beginning of s.
AllowTrailingWhite El ws elemento al final de s.The ws element at the end of s.
AllowLeadingSign El sesión elemento situado al principio de s.The sign element at the beginning of s.
AllowTrailingSign El sesión elemento al final de s.The sign element at the end of s.
AllowParentheses El sesión elemento con la forma de paréntesis para delimitar el valor numérico.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands El , elemento.The , element.
AllowCurrencySymbol El $ elemento.The $ element.
Currency Todos.All. El s parámetro no puede representar un número hexadecimal o un número en notación exponencial.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
Float El ws elemento al principio o al final de s, sesión al principio de sy el .The ws element at the beginning or end of s, sign at the beginning of s, and the . símbolo.symbol. El s parámetro también puede utilizar la notación exponencial.The s parameter can also use exponential notation.
Number El ws, sign, miles separador (,), y separador decimal (.) elementos.The ws, sign, thousands separator (,), and decimal point (.) elements.
Any Todos los estilos, excepto s no se puede representar un número hexadecimal.All styles, except s cannot represent a hexadecimal number.

El provider parámetro es un IFormatProvider implementación, como un NumberFormatInfo o CultureInfo objeto.The provider parameter is a IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. El provider parámetro proporciona información específica de la referencia cultural usada en el análisis.The provider parameter supplies culture-specific information used in parsing. Si provider es null o NumberFormatInfo no se puede obtener el objeto, se usa la información de formato para la referencia cultural actual.If provider is null or a NumberFormatInfo object cannot be obtained, the format information for the current culture is used.

Se produce un error en la conversión si el s parámetro es null o un valor no numérico, el provider parámetro no produce un NumberFormatInfo objeto, o el style parámetro no es una combinación de marcas de bits de la NumberStyles enumeración.The conversion fails if the s parameter is null or not a numeric value, the provider parameter does not yield a NumberFormatInfo object, or the style parameter is not a combination of bit flags from the NumberStyles enumeration.

Normalmente, si se pasa el Double.TryParse método una cadena que se crea mediante una llamada a la Double.ToString método, el original Double se devuelve el valor.Ordinarily, if you pass the Double.TryParse method a string that is created by calling the Double.ToString method, the original Double value is returned. Sin embargo, debido a una pérdida de precisión, los valores pueden no ser iguales.However, because of a loss of precision, the values may not be equal. Además, al intentar analizar la representación de cadena MinValue o MaxValue produce una OverflowException, tal y como se muestra en el ejemplo siguiente.In addition, attempting to parse the string representation of either MinValue or MaxValue throws an OverflowException, as the following example illustrates.

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;
      
      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.", 
                           value);
      
      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.            
Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.            

Si se encuentra un separador en la s parámetro durante una operación de análisis y la divisa aplicable o número decimal y separadores de grupo son iguales, la operación de análisis supone que se trata de un separador decimal en lugar de un grupo separador.If a separator is encountered in the s parameter during a parse operation, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. Para obtener más información acerca de los separadores, consulte CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, y NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Consulte también:

Se aplica a