Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Byte.Parse (String, NumberStyles)

 

Publicado: octubre de 2016

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
Type: System.String

Cadena que contiene un número que se va a convertir. La cadena se interpreta usando el estilo especificado por style.

style
Type: System.Globalization.NumberStyles

Combinación bit a bit de los 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

Type: System.Byte

Un valor de byte que es equivalente al número contenido en s.

Exception Condition
ArgumentNullException

El valor de 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 NumberStyles.

O bien

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

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

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

O bien, si style incluye AllowHexSpecifier:

[eb] dígitos hexadecimales [eb]

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

Elemento

Descripción

ws

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

$

Un símbolo de moneda específico de la referencia cultural. Su posición en la cadena viene definida por el NumberFormatInfo.CurrencyPositivePattern propiedad de la referencia cultural actual. Símbolo de divisa de la referencia cultural actual puede aparecer en s si style incluye la NumberStyles.AllowCurrencySymbol marca.

sign

Un signo positivo opcional. (El método produce una OverflowException si se encuentra en un signo negativo s.) El signo puede aparecer al principio de s si style incluye la NumberStyles.AllowLeadingSign marca, o al final de s si style incluye la NumberStyles.AllowTrailingSign marca.

dígitos

Una secuencia de dígitos comprendido entre 0 y 9.

.

Un símbolo de separador decimal de referencias culturales específicas. Símbolo de separador decimal de la referencia cultural actual puede aparecer en s si style incluye la NumberStyles.AllowDecimalPoint marca.

dígitos fraccionarios

Una o más apariciones del dígito 0. Pueden aparecer dígitos fraccionarios en s solo si style incluye la NumberStyles.AllowDecimalPoint marca.

h

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

dígitos hexadecimales

Una secuencia de dígitos hexadecimales de 0 a f o 0 hasta la f el.

Una cadena únicamente por dígitos decimales (que corresponde a la NumberStyles.None estilo) siempre se analiza correctamente. La mayoría de las restantes NumberStyles miembros controlan los elementos que pueden ser pero no tienen que estar presentes en esta cadena de entrada. La tabla siguiente se indica cómo individuales NumberStyles miembros 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

Dígitos decimales.

NumberStyles.AllowDecimalPoint

El . y dígitos fraccionarios elementos. Sin embargo, dígitos fraccionarios deben constar de uno o más dígitos 0 o un OverflowException se produce.

NumberStyles.AllowExponent

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

NumberStyles.AllowLeadingWhite

El ws elemento situado al principio de s.

NumberStyles.AllowTrailingWhite

El ws elemento situado al final de s.

NumberStyles.AllowLeadingSign

Puede aparecer un signo positivo antes dígitos.

NumberStyles.AllowTrailingSign

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

NumberStyles.AllowParentheses

Aunque se admite este marcador, el uso de paréntesis en s da como resultado un OverflowException.

NumberStyles.AllowThousands

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

NumberStyles.AllowCurrencySymbol

El $ elemento.

Si el NumberStyles.AllowHexSpecifier se utiliza la marca, s debe ser un valor hexadecimal sin prefijo. Por ejemplo, "F3" se analiza correctamente, pero no "0xF3". Son los únicos otros marcadores que se pueden combinar con él NumberStyles.AllowLeadingWhite y NumberStyles.AllowTrailingWhite. (El NumberStyles enumeración incluye un estilo de número compuesto, NumberStyles.HexNumber, que incluye ambos marcadores de espacio en blanco.)

El s parámetro se analiza utilizando la información de formato en un NumberFormatInfo objeto 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 Byte.Parse(String, NumberStyles, IFormatProvider) de sobrecarga.

En el ejemplo siguiente se analiza representaciones de cadena de Byte los valores que tienen la Byte.Parse(String, NumberStyles) método. 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.            

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: