Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Byte.Parse (Método) (String, NumberStyles, IFormatProvider)

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

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)
public static byte Parse(
	string s,
	NumberStyles style,
	IFormatProvider provider
)

Parámetros

s
Tipo: System.String
Cadena que contiene un número que se va a convertir. La cadena se interpreta utilizando el estilo especificado por style.
style
Tipo: System.Globalization.NumberStyles
Combinación bit a bit de valores de enumeración que indica los elementos de estilo que pueden estar presentes en s. Un valor que se especifica de forma habitual es NumberStyles.Integer.
provider
Tipo: System.IFormatProvider
Un objeto que aporta información específica de la referencia cultural sobre el formato de s. Si provider es null, se utiliza la referencia cultural actual del subproceso.

Valor devuelto

Tipo: System.Byte
Valor de tipo byte equivalente al número contenido en s.
ExcepciónCondición
ArgumentNullException

s es null.

FormatException

s no tiene el formato correcto.

OverflowException

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

O bien

s incluye dígitos fraccionarios distintos de cero.

ArgumentException

style no es un valor de NumberStyles.

O bien

style no es una combinación de valores NumberStyles.AllowHexSpecifier y NumberStyles.HexNumber.

El parámetro style define los elementos de estilo (como espacios en blanco o el signo positivo) que se permiten en el parámetro s para que la operación de análisis se realice correctamente. Debe ser una combinación de marcas de bit de la enumeración NumberStyles. En función del valor de style, el parámetro s puede incluir los elementos siguientes:

[eb][$][signo]dígitos[.dígitos fraccionarios][e[signo]dígitos][eb]

O bien, si el parámetro style incluye AllowHexSpecifier:

[eb]dígitos hexadecimales[eb]

Los elementos entre corchetes ([ y ]) son opcionales. En la tabla siguiente se describe cada elemento.

Elemento

Descripción

eb

Espacio en blanco opcional. El espacio en blanco puede aparecer al principio de s si style incluye la marca NumberStyles.AllowLeadingWhite, o al final de s si style incluye la marca NumberStyles.AllowTrailingWhite.

$

Símbolo de divisa específico de la referencia cultural. Su posición en la cadena viene definida por la propiedad NumberFormatInfo.CurrencyPositivePattern del objeto NumberFormatInfo devuelto por el método GetFormat del parámetro provider. El símbolo de divisa puede aparecer en s si style incluye la marca NumberStyles.AllowCurrencySymbol.

sign

Signo positivo opcional. (El método inicia OverflowException si hay un signo negativo presente en s.) El signo puede aparecer al principio de s si style incluye la marca NumberStyles.AllowLeadingSign, o al final de s si style incluye la marca NumberStyles.AllowTrailingSign.

dígitos

Secuencia de dígitos de 0 a 9.

.

Símbolo separador de decimales específico de la referencia cultural. El símbolo separador de decimales de la referencia cultural especificada por provider puede aparecer en s si style incluye la marca NumberStyles.AllowDecimalPoint.

dígitos fraccionarios

Una o más apariciones del dígito 0. Sólo pueden aparecer dígitos fraccionarios en s si style incluye la marca NumberStyles.AllowDecimalPoint.

e

Carácter e o E, que indica que el valor se representa en notación exponencial. El parámetro s puede representar un número en notación exponencial si style incluye la marca NumberStyles.AllowExponent.

dígitos hexadecimales

Secuencia de dígitos hexadecimales de 0 a f o de 0 a F.

Una cadena formada únicamente por dígitos decimales (que se corresponde con el estilo NumberStyles.None) siempre se analiza correctamente. La mayoría de los miembros NumberStyles restantes controlan los elementos que pueden estar presentes en esta cadena de entrada, aunque no sea preciso. La tabla siguiente indica la forma en que los miembros NumberStyles individuales afectan a los elementos que pueden estar presentes en s.

Valores NumberStyles no compuestos

Elementos permitidos en s además de dígitos

NumberStyles.None

Solo dígitos decimales.

NumberStyles.AllowDecimalPoint

Elementos . y dígitos fraccionarios. No obstante, el elemento dígitos fraccionarios solo debe incluir uno o más dígitos 0 porque, de lo contrario, se iniciará OverflowException.

NumberStyles.AllowExponent

El parámetro s también puede utilizar la notación exponencial.

NumberStyles.AllowLeadingWhite

Elemento eb al principio de s.

NumberStyles.AllowTrailingWhite

Elemento eb al final de s.

NumberStyles.AllowLeadingSign

Puede aparecer un signo positivo antes del elemento dígitos.

NumberStyles.AllowTrailingSign

Puede aparecer un signo positivo después del elemento dígitos.

NumberStyles.AllowParentheses

Aunque se admite esta marca, el uso de paréntesis en s da lugar a OverflowException.

NumberStyles.AllowThousands

Aunque el símbolo separador de grupos puede aparecer en s, solo puede ir precedido de uno o más dígitos 0.

NumberStyles.AllowCurrencySymbol

Elemento $.

Si se utiliza la marca NumberStyles.AllowHexSpecifier, s debe ser un valor hexadecimal. Las únicas otras marcas que pueden estar presentes en style son NumberStyles.AllowLeadingWhite y NumberStyles.AllowTrailingWhite. (La enumeración NumberStyles tiene un estilo de número compuesto, NumberStyles.HexNumber, que incluye ambas marcas de espacio en blanco.)

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

En el ejemplo de código siguiente se analizan las representaciones de cadena de valores de tipo Byte con esta sobrecarga del método Byte.Parse(String, NumberStyles, IFormatProvider).


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

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float;     
culture = CultureInfo.CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo.CreateSpecificCulture("en-GB");
try
{
   number = Byte.Parse(value, style, culture);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }   

value = "12.000";
number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.