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

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

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

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

public static byte Parse(
	string s,
	NumberStyles style
)

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.

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 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 el estilo 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 de la referencia cultural actual. El símbolo de divisa de la referencia cultural actual 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 actual 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 combinarse con él son NumberStyles.AllowLeadingWhite y NumberStyles.AllowTrailingWhite. (La enumeración NumberStyles incluye un estilo de número compuesto, NumberStyles.HexNumber, que incluye ambas marcas de espacio en blanco.)

El parámetro s se analiza usando la información de formato de un objeto NumberFormatInfo que se inicializa para la referencia cultural del sistema actual. Para utilizar la información de formato de alguna otra referencia cultural, llame a la sobrecarga de Byte.Parse(String, NumberStyles, IFormatProvider).

En el siguiente ejemplo se analizan representaciones de cadena de valores de tipo Byte con el método Byte.Parse(String, NumberStyles). La referencia cultural actual del ejemplo es en-US.


string value;
NumberStyles style;
byte number;

// Parse value with no styles allowed.
style = NumberStyles.None;
value = " 241 ";
try
{
   number = Byte.Parse(value, style);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }   

// Parse value with trailing sign.
style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
value = " 163+";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.            


.NET Framework

Compatible con: 4.5.2, 4.5.1, 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

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft