Single.TryParse Método

Definición

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión sencilla equivalente.Converts the string representation of a number to its single-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, Single)

Convierte la representación de intervalo de un número con el estilo y el formato específico de la referencia cultural que se hayan especificado en el número de punto flotante de precisión sencilla equivalente.Converts the span representation of a number in a specified style and culture-specific format to its single-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(String, Single)

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión sencilla equivalente.Converts the string representation of a number to its single-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>, Single)

Convierte la representación de cadena de un número de un intervalo de caracteres a su número de punto flotante de precisión sencilla equivalente.Converts the string representation of a number in a character span to its single-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(String, NumberStyles, IFormatProvider, Single)

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 sencilla equivalente.Converts the string representation of a number in a specified style and culture-specific format to its single-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.

Comentarios

En .NET Core 3,0 y versiones posteriores, los valores que son demasiado grandes para representarlos se redondean a PositiveInfinity o NegativeInfinity como requiere la especificación IEEE 754.In .NET Core 3.0 and later, values that are too large to represent are rounded to PositiveInfinity or NegativeInfinity as required by the IEEE 754 specification. En versiones anteriores, incluyendo .NET Framework, el análisis de un valor que era demasiado grande para representar resultó en un error.In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure.

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

Convierte la representación de intervalo de un número con el estilo y el formato específico de la referencia cultural que se hayan especificado en el número de punto flotante de precisión sencilla equivalente.Converts the span representation of a number in a specified style and culture-specific format to its single-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(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Parámetros

s
ReadOnlySpan<Char>

Un intervalo de caracteres de solo lectura que contiene el número que se va a convertir.A read-only character span that contains the number to convert. El intervalo se interpreta mediante el estilo especificado por styleThe span is interpreted using the style specified by style

style
NumberStyles

Combinación bit a bit de valores de enumeración que indica el formato permitido de s.A bitwise combination of enumeration 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

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

result
Single

Cuando se devuelve este método, contiene el número de punto flotante de precisión sencilla equivalente al valor numérico o al símbolo contenido en s si la conversión se realizó correctamente, o cero si no se realizó correctamente.When this method returns, contains the single-precision floating-point number equivalent to 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

Boolean

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

Comentarios

En .NET Core 3,0 y versiones posteriores, los valores que son demasiado grandes para representarlos se redondean a PositiveInfinity o NegativeInfinity como requiere la especificación IEEE 754.In .NET Core 3.0 and later, values that are too large to represent are rounded to PositiveInfinity or NegativeInfinity as required by the IEEE 754 specification. En versiones anteriores, incluyendo .NET Framework, el análisis de un valor que era demasiado grande para representar resultó en un error.In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure.

Se aplica a

TryParse(String, Single)

Convierte la representación en forma de cadena de un número en el número de punto flotante de precisión sencilla equivalente.Converts the string representation of a number to its single-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] float % result);
public static bool TryParse (string s, out float result);
public static bool TryParse (string? s, out float? result);
static member TryParse : string * single -> bool
Public Shared Function TryParse (s As String, ByRef result As Single) As Boolean

Parámetros

s
String

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

result
Single

Cuando se devuelve este método, contiene el número de punto flotante de precisión sencilla equivalente al valor numérico o al símbolo contenido en s si la conversión se realizó correctamente, o cero si no se realizó correctamente.When this method returns, contains single-precision floating-point number equivalent to 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, o bien no es un número en un formato correcto.The conversion fails if the s parameter is null or Empty or is not a number in a valid format. También se produce un error en .NET Framework y .NET Core 2.2 y versiones anteriores si s representa un número menor que MinValue o mayor que MaxValue.It also fails on .NET Framework and .NET Core 2.2 and earlier versions if s 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

Boolean

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, Single) método para convertir las representaciones de cadena de valores numéricos en Single valores.The following example uses the TryParse(String, Single) method to convert the string representations of numeric values to Single values. Se supone que en-US es la referencia cultural actual.It assumes that en-US is the current culture.

string value;
float number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a floating-point value with a currency symbol and a
// thousands separator.
value = "$1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse value in exponential notation.
value = "-1.643e6";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.689346E+17
Dim value As String
Dim number As Single

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a floating-point value with a currency symbol and a
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If
' The example displays the following output:
'       1643.57
'       Unable to parse '$1,643.57'.
'       -1643000
'       -1.689346E+17

Comentarios

En .NET Core 3,0 y versiones posteriores, los valores que son demasiado grandes para representarlos se redondean a PositiveInfinity o NegativeInfinity como requiere la especificación IEEE 754.In .NET Core 3.0 and later, values that are too large to represent are rounded to PositiveInfinity or NegativeInfinity as required by the IEEE 754 specification. En versiones anteriores, incluyendo .NET Framework, el análisis de un valor que era demasiado grande para representar resultó en un error.In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure.

Esta sobrecarga difiere del Single.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 Single.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 un FormatException en el evento que s no es válido y no se puede analizar 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 PositiveInfinitySymbol , NegativeInfinitySymbol , NaNSymbol (la comparación de cadenas distingue entre mayúsculas y minúsculas) o una cadena con el formato:The s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol (the string comparison is case-sensitive), or a string of the form:

WS sesión [dígitos enteros,] dígitos enteros [. [ dígitos fraccionarios]] [e [signo] dígitos exponenciales] [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.
dígitos enterosintegral-digits 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. Los 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 grupos específico de la referencia cultural.A culture-specific group separator symbol.
.. Un símbolo de separador decimal específico de la referencia cultural.A culture-specific decimal point symbol.
dígitos fraccionariosfractional-digits 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 Carácter en mayúsculas o minúsculas ' e ' que indica la notación exponencial (científica).An uppercase or lowercase character 'e', that indicates exponential (scientific) notation.
dígitos exponencialesexponential-digits Serie de caracteres numéricos comprendidos entre 0 y 9 que especifican un exponente.A series of numeric characters ranging from 0 to 9 that specify an exponent.

El s parámetro se interpreta utilizando una combinación de las NumberStyles.Float NumberStyles.AllowThousands marcas y.The s parameter is interpreted using a combination of the NumberStyles.Float and NumberStyles.AllowThousands flags. Esto significa que los espacios en blanco y los separadores de miles están permitidos, pero no los 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 los símbolos de moneda, los separadores de miles y los espacios en blanco) que pueden estar presentes en s , utilice la TryParse(String, NumberStyles, IFormatProvider, Single) 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 TryParse(String, NumberStyles, IFormatProvider, Single) method overload.

El s parámetro se analiza utilizando la información de formato de un NumberFormatInfo objeto que se inicializa para la referencia cultural del sistema actual.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 formato de alguna otra referencia cultural especificada, use la TryParse(String, NumberStyles, IFormatProvider, Single) sobrecarga del método.To parse a string using the formatting information of some other specified culture, use the TryParse(String, NumberStyles, IFormatProvider, Single) method overload.

Normalmente, si se pasa al Single.TryParse método una cadena que se crea llamando al Single.ToString método, Single se devuelve el valor original.Ordinarily, if you pass the Single.TryParse method a string that is created by calling the Single.ToString method, the original Single value is returned. Sin embargo, debido a una pérdida de precisión, es posible que los valores no sean iguales.However, because of a loss of precision, the values may not be equal.

Si s está fuera del intervalo del Single tipo de datos, el método devuelve false en .NET Framework y .net Core 2,2 y versiones anteriores.If s is out of range of the Single data type, the method returns false on .NET Framework and .NET Core 2.2 and earlier versions. En .NET Core 3,0 y versiones posteriores, devuelve Single.NegativeInfinity si s es menor que Single.MinValue y Single.PositiveInfinity si s es mayor que Single.MaxValue .On .NET Core 3.0 and later versions, it returns Single.NegativeInfinity if s is less than Single.MinValue and Single.PositiveInfinity if s is greater than Single.MaxValue.

Si se encuentra un separador en el s parámetro durante una operación de análisis, y los separadores de moneda o de número decimal y de grupo correspondientes son iguales, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de grupos.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, vea CurrencyDecimalSeparator ,, NumberDecimalSeparator CurrencyGroupSeparator y NumberGroupSeparator .For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Consulte también

Se aplica a

TryParse(ReadOnlySpan<Char>, Single)

Convierte la representación de cadena de un número de un intervalo de caracteres a su número de punto flotante de precisión sencilla equivalente.Converts the string representation of a number in a character span to its single-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(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, out float result);
static member TryParse : ReadOnlySpan<char> * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Single) As Boolean

Parámetros

s
ReadOnlySpan<Char>

>Un intervalo de caracteres que contiene la representación de cadena del número que se va a convertir.>A character span that contains the string representation of the number to convert.

result
Single

Cuando este método devuelve un valor, contiene el número de punto flotante de precisión sencilla equivalente al parámetro s si la conversión se ha realizado correctamente, o bien cero en caso contrario.When this method returns, contains the single-precision floating-point number equivalent of the s parameter, 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 está vacío, o bien no es un número en un formato válido.The conversion fails if the s parameter is null or empty or is not a number in a valid format. Si es un número válido menor que MinValue, result es NegativeInfinity.If is a valid number less than MinValue, result is NegativeInfinity. Si es un número válido mayor que MaxValue, result es PositiveInfinity.If is a valid number greater than MaxValue, result is PositiveInfinity. 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

Boolean

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

Comentarios

En .NET Core 3,0 y versiones posteriores, los valores que son demasiado grandes para representarlos se redondean a PositiveInfinity o NegativeInfinity como requiere la especificación IEEE 754.In .NET Core 3.0 and later, values that are too large to represent are rounded to PositiveInfinity or NegativeInfinity as required by the IEEE 754 specification. En versiones anteriores, incluyendo .NET Framework, el análisis de un valor que era demasiado grande para representar resultó en un error.In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure.

Se aplica a

TryParse(String, NumberStyles, IFormatProvider, Single)

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 sencilla equivalente.Converts the string representation of a number in a specified style and culture-specific format to its single-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] float % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float? result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Parámetros

s
String

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

style
NumberStyles

Combinación bit a bit de valores de enumeración que indica el formato permitido de s.A bitwise combination of enumeration 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

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

result
Single

Cuando se devuelve este método, contiene el número de punto flotante de precisión sencilla equivalente al valor numérico o al símbolo contenido en s si la conversión se realizó correctamente, o cero si no se realizó correctamente.When this method returns, contains the single-precision floating-point number equivalent to 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, 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, or if style is not a valid combination of NumberStyles enumeration constants. También se produce un error en .NET Framework o .NET Core 2.2 y versiones anteriores si s representa un número menor que MinValue o mayor que MaxValue.It also fails on .NET Framework or .NET Core 2.2 and earlier versions if s 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

Boolean

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 es el valor AllowHexSpecifier.style is the AllowHexSpecifier value.

Ejemplos

En el ejemplo siguiente se muestra el uso del Single.TryParse(String, NumberStyles, IFormatProvider, Single) método para analizar la representación de cadena de los números que tienen un estilo determinado y a los que se les da formato mediante las convenciones de una referencia cultural determinada.The following example demonstrates the use of the Single.TryParse(String, NumberStyles, IFormatProvider, Single) 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;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;

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

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

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

value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.
Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = System.Globalization.NumberStyles.Number Or _
        System.Globalization.NumberStyles.AllowCurrencySymbol
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If

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

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

value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If
' The example displays the following output:
'       Converted '£1,097.63' to 1097.63.
'       Converted '1345,978' to 1345.978.
'       Converted '1.345,978' to 1345.978.
'       Unable to convert '1 345,978'.

Comentarios

En .NET Core 3,0 y versiones posteriores, los valores que son demasiado grandes para representarlos se redondean a PositiveInfinity o NegativeInfinity como requiere la especificación IEEE 754.In .NET Core 3.0 and later, values that are too large to represent are rounded to PositiveInfinity or NegativeInfinity as required by the IEEE 754 specification. En versiones anteriores, incluyendo .NET Framework, el análisis de un valor que era demasiado grande para representar resultó en un error.In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure.

Esta sobrecarga difiere del Parse(String, NumberStyles, IFormatProvider) 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 Parse(String, NumberStyles, IFormatProvider) 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 un FormatException en el evento que s no es válido y no se puede analizar 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 style parámetro define el formato permitido del s parámetro para que 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. NumberStylesNo se admiten los siguientes miembros:The following NumberStyles members are not supported:

El s parámetro puede contener PositiveInfinitySymbol , NegativeInfinitySymbol , NaNSymbol para la referencia cultural indicada por provider .The s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, 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 [$] sesión [dígitos enteros,] dígitos enteros [. fracciones-dígitos] [e [signo] dígitos exponenciales] [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. Puede aparecer un espacio 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 divisa específico de la referencia cultural.A culture-specific currency symbol. Su posición en la cadena se define mediante las NumberFormatInfo.CurrencyNegativePattern NumberFormatInfo.CurrencyPositivePattern propiedades o del NumberFormatInfo objeto devuelto por el IFormatProvider.GetFormat método del 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. El símbolo de moneda puede aparecer 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 signo 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. Los paréntesis se pueden usar 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.
dígitos enterosintegral-digits Serie de dígitos que van 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. Los 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 miles específico de la referencia cultural.A culture-specific thousands separator symbol. El símbolo del separador de miles de la referencia cultural actual 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 decimal específico de la referencia cultural.A culture-specific decimal point symbol. El 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.
dígitos fraccionariosfractional-digits Serie de dígitos que van 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. Los dígitos fraccionarios pueden aparecer 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 la 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.
dígitos exponencialesexponential-digits Serie de dígitos que van del 0 al 9 que especifican un exponente.A series of digits ranging from 0 to 9 that specify an exponent.

Nota

Los caracteres NUL de terminación (U + 0000) de s se omiten en la operación de análisis, independientemente del valor del 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 solo con dígitos (que corresponde al NumberStyles.None estilo) siempre se analiza correctamente si está en el intervalo del Single tipo.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully if it is in the range of the Single type. Los System.Globalization.NumberStyles miembros restantes controlan los elementos que pueden estar presentes en la cadena de entrada, pero que no son necesarios.The remaining System.Globalization.NumberStyles members control elements that may be but are not required to be present in the input string. En la tabla siguiente se indica cómo NumberStyles afectan las marcas individuales 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 Solo el elemento de dígitos enteros .The integral-digits element only.
AllowDecimalPoint El elemento de lenguaje .The . y los elementos de dígitos fraccionarios .and fractional-digits elements.
AllowExponent El s parámetro también puede usar la notación exponencial.The s parameter can also use exponential notation. Este marcador por sí solo admite valores con el formato dígitos de dígitos enteros E exponencial-digits; se necesitan marcas adicionales para analizar correctamente las cadenas en notación exponencial con elementos como signos positivos o negativos y símbolos de separador decimal.This flag by itself supports values in the form integral-digits E exponential-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 Elemento WS al principio de s .The ws element at the beginning of s.
AllowTrailingWhite Elemento WS al final de s .The ws element at the end of s.
AllowLeadingSign Elemento de signo situado al principio de s .The sign element at the beginning of s.
AllowTrailingSign El elemento Sign al final de s .The sign element at the end of s.
AllowParentheses El elemento Sign en el formato de paréntesis que rodea el valor numérico.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands El elemento , .The , element.
AllowCurrencySymbol $ 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 elemento WS al principio o al final de s , Sign al principio de s y .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 usar la notación exponencial.The s parameter can also use exponential notation.
Number Los ws sign elementos,, separador de miles (,) y punto decimal (.).The ws, sign, thousands separator (,), and decimal point (.) elements.
Any Todos los estilos, excepto s no pueden representar un número hexadecimal.All styles, except s cannot represent a hexadecimal number.

El provider parámetro es una IFormatProvider implementación de cuyo GetFormat método devuelve un NumberFormatInfo objeto que proporciona información de formato específica de la referencia cultural.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Cuando TryParse(String, NumberStyles, IFormatProvider, Single) se invoca el método, llama al provider método del parámetro GetFormat y le pasa un Type objeto que representa el NumberFormatInfo tipo.When the TryParse(String, NumberStyles, IFormatProvider, Single) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. GetFormatDespués, el método devuelve el NumberFormatInfo objeto que proporciona información sobre el formato del s parámetro.The GetFormat method then returns the NumberFormatInfo object that provides information about the format of the s parameter. Hay tres maneras de usar el provider parámetro para proporcionar información de formato personalizada a la operación de análisis:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Puede pasar un CultureInfo objeto que represente la referencia cultural que proporciona información de formato.You can pass a CultureInfo object that represents the culture that supplies formatting information. Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato numérico para esa referencia cultural.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Puede pasar el objeto real NumberFormatInfo que proporciona información de formato numérico.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Su implementación de GetFormat simplemente se devuelve).(Its implementation of GetFormat just returns itself.)

  • Puede pasar un objeto personalizado que implementa IFormatProvider .You can pass a custom object that implements IFormatProvider. Su GetFormat método crea una instancia de y devuelve el NumberFormatInfo objeto que proporciona información de formato.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Si provider es null , el formato de s se interpreta basándose en el NumberFormatInfo objeto de la referencia cultural actual.If provider is null, the formatting of s is interpreted based on the NumberFormatInfo object of the current culture.

Si s está fuera del intervalo del Single tipo de datos, el método inicia una excepción OverflowException en .NET Framework y .net Core 2,2 y versiones anteriores.If s is out of range of the Single data type, the method throws an OverflowException on .NET Framework and .NET Core 2.2 and earlier versions. En .NET Core 3,0 y versiones posteriores, devuelve Single.NegativeInfinity si s es menor que Single.MinValue y Single.PositiveInfinity si s es mayor que Single.MaxValue .On .NET Core 3.0 and later versions, it returns Single.NegativeInfinity if s is less than Single.MinValue and Single.PositiveInfinity if s is greater than Single.MaxValue.

Si se encuentra un separador en el s parámetro durante una operación de análisis, y los separadores de moneda o de número decimal y de grupo correspondientes son iguales, la operación de análisis supone que el separador es un separador decimal en lugar de un separador de grupos.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, vea CurrencyDecimalSeparator ,, NumberDecimalSeparator CurrencyGroupSeparator y NumberGroupSeparator .For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Consulte también

Se aplica a