Byte.Parse Método

Definición

Convierte la representación en forma de cadena de un número en su Byte equivalente.Converts the string representation of a number to its Byte equivalent.

Sobrecargas

Parse(String, NumberStyles, IFormatProvider)

Convierte la representación de cadena de un número con el estilo y el formato específico de la referencia cultural que se hayan especificado en su equivalente de Byte.Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Convierte la representación del intervalo de un número con el estilo y el formato específicos de la referencia cultural especificados en su equivalente de Byte.Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent.

Parse(String, NumberStyles)

Convierte la representación de cadena de un número con un estilo especificado en su Byte equivalente.Converts the string representation of a number in a specified style to its Byte equivalent.

Parse(String)

Convierte la representación en forma de cadena de un número en su Byte equivalente.Converts the string representation of a number to its Byte equivalent.

Parse(String, IFormatProvider)

Convierte la representación en forma de cadena de un número con el formato específico de la referencia cultural indicada en su Byte equivalente.Converts the string representation of a number in a specified culture-specific format to its Byte equivalent.

Parse(String, NumberStyles, IFormatProvider)

Convierte la representación de cadena de un número con el estilo y el formato específico de la referencia cultural que se hayan especificado en su equivalente de Byte.Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public static byte Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> byte
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Byte

Parámetros

s
String

Cadena que contiene un número que se va a convertir.A string that contains a number to convert. La cadena se interpreta usando el estilo especificado por style.The string is interpreted using the style specified by style.

style
NumberStyles

Combinación bit a bit de los valores de enumeración que indica los elementos de estilo que pueden estar presentes en s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Un valor que se especifica de forma habitual es Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objeto que aporta información específica de la referencia cultural acerca del formato de s.An object that supplies culture-specific information about the format of s. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Devoluciones

Un valor de byte que es equivalente al número contenido en s.A byte value that is equivalent to the number contained in s.

Excepciones

s es null.s is null.

s no tiene el formato correcto.s is not of the correct format.

s representa un número menor que MinValue o mayor que MaxValue.s represents a number less than MinValue or greater than MaxValue.

O bien-or- s incluye dígitos fraccionarios distintos de cero.s includes non-zero, fractional digits.

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

O bien-or- style no es una combinación de valores AllowHexSpecifier y HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Ejemplos

En el ejemplo de código siguiente se analizan las representaciones de cadena de Byte valores con esta sobrecarga del método Byte.Parse(String, NumberStyles, IFormatProvider).The following code example parses string representations of Byte values with this overload of the Byte.Parse(String, NumberStyles, IFormatProvider) method.

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.
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.
Dim style As NumberStyles
Dim culture As CultureInfo
Dim value As String
Dim number As Byte

' 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 e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try      

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.

Comentarios

El parámetro style define los elementos de estilo (como el espacio 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.The style parameter defines the style elements (such as white space or the positive sign) that are allowed in the s parameter for the parse operation to succeed. Debe ser una combinación de marcas de bits de la enumeración NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. Dependiendo del valor de style, el parámetro s puede incluir los siguientes elementos:Depending on the value of style, the s parameter may include the following elements:

[ws][$][sign]digits[.fractional_digits][e[sign]digits][ws][ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]

O bien, si el parámetro style incluye AllowHexSpecifier:Or, if the style parameter includes AllowHexSpecifier:

[ws] hexdigits [ws][ws]hexdigits[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 marca NumberStyles.AllowLeadingWhite o al final de s si style incluye la marca NumberStyles.AllowTrailingWhite.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or 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. La propiedad NumberFormatInfo.CurrencyPositivePattern del objeto NumberFormatInfo devuelto por el método GetFormat del parámetro provider define su posición en la cadena.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. El símbolo de moneda puede aparecer en s si style incluye la marca NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Un signo positivo opcional.An optional positive sign. (El método produce una OverflowException si hay un signo negativo 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.(The method throws an OverflowException if a negative sign is present in s.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, or at the end of s if style includes the NumberStyles.AllowTrailingSign flag.
digitsdigits Secuencia de dígitos del 0 al 9.A sequence of digits from 0 through 9.
.. 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 especificada por provider puede aparecer en s si style incluye la marca NumberStyles.AllowDecimalPoint.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Una o más apariciones del dígito 0.One or more occurrences of the digit 0. Los dígitos fraccionarios solo pueden aparecer en s si style incluye la marca NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee El carácter e o E, que indica que el valor se representa en notación exponencial.The e or E character, which indicates that the value is represented in exponential notation. El parámetro s puede representar un número en notación exponencial si style incluye la marca NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Secuencia de dígitos hexadecimales de 0 a f, o de 0 a F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Nota

La operación de análisis omite los caracteres NUL (U + 0000) de terminación de s, independientemente del valor del argumento style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Una cadena con dígitos decimales únicamente (que corresponde al estilo NumberStyles.None) siempre se analiza correctamente.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. La mayoría de los miembros de la NumberStyles restantes controlan los elementos que pueden estar presentes en esta cadena de entrada, pero que no son necesarios.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. En la tabla siguiente se indica cómo los miembros de NumberStyles individuales afectan a los elementos que pueden estar presentes en s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valores NumberStyles no compuestosNon-composite NumberStyles values Elementos permitidos en s además de dígitosElements permitted in s in addition to digits
NumberStyles.None Solo dígitos decimales.Decimal digits only.
NumberStyles.AllowDecimalPoint El elemento de lenguaje .The . y fractional_digits elementos.and fractional_digits elements. Sin embargo, fractional_digits debe constar solo de uno o más dígitos 0 o se produce una OverflowException.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent El parámetro s también puede usar la notación exponencial.The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite Elemento WS al principio de s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Elemento WS al final de s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Un signo positivo puede aparecer antes que los dígitos.A positive sign can appear before digits.
NumberStyles.AllowTrailingSign Un signo positivo puede aparecer después de los dígitos.A positive sign can appear after digits.
NumberStyles.AllowParentheses Aunque se admite esta marca, el uso de paréntesis en s da como resultado un OverflowException.Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands Aunque el símbolo de separador de grupos puede aparecer en s, solo puede ir precedido de uno o más dígitos 0.Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol El elemento $ .The $ element.

Si se usa la marca NumberStyles.AllowHexSpecifier, s debe ser un valor hexadecimal sin prefijo.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Por ejemplo, "F3" se analiza correctamente, pero "0xF3" no lo hace.For example, "F3" parses successfully, but "0xF3" does not. Las demás marcas que pueden estar presentes en style son NumberStyles.AllowLeadingWhite y NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (La enumeración NumberStyles tiene un estilo de número compuesto, NumberStyles.HexNumber, que incluye ambas marcas de espacio en blanco).(The NumberStyles enumeration has a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

El parámetro provider es una implementación de IFormatProvider, como un objeto NumberFormatInfo o CultureInfo.The provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. El parámetro provider proporciona información específica de la referencia cultural que se usa en el análisis.The provider parameter supplies culture-specific information used in parsing. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Consulte también:

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Convierte la representación del intervalo de un número con el estilo y el formato específicos de la referencia cultural especificados en su equivalente de Byte.Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent.

public static byte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> byte
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As Byte

Parámetros

s
ReadOnlySpan<Char>

Intervalo que contiene los caracteres que representan el valor que se va a convertir.A span containing the characters representing the value to convert.

style
NumberStyles

Combinación bit a bit de los valores de enumeración que indica los elementos de estilo que pueden estar presentes en s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Un valor que se especifica de forma habitual es Integer.A typical value to specify is Integer.

provider
IFormatProvider

Objeto que aporta información específica de la referencia cultural acerca del formato de s.An object that supplies culture-specific information about the format of s. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Devoluciones

Un valor de byte que es equivalente al número contenido en s.A byte value that is equivalent to the number contained in s.

Parse(String, NumberStyles)

Convierte la representación de cadena de un número con un estilo especificado en su Byte equivalente.Converts the string representation of a number in a specified style to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static byte Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> byte
Public Shared Function Parse (s As String, style As NumberStyles) As Byte

Parámetros

s
String

Cadena que contiene un número que se va a convertir.A string that contains a number to convert. La cadena se interpreta usando el estilo especificado por style.The string is interpreted using the style specified by style.

style
NumberStyles

Combinación bit a bit de los valores de enumeración que indica los elementos de estilo que pueden estar presentes en s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Un valor que se especifica de forma habitual es Integer.A typical value to specify is Integer.

Devoluciones

Un valor de byte que es equivalente al número contenido en s.A byte value that is equivalent to the number contained in s.

Excepciones

s es null.s is null.

s no tiene el formato correcto.s is not of the correct format.

s representa un número menor que MinValue o mayor que MaxValue.s represents a number less than MinValue or greater than MaxValue.

O bien-or- s incluye dígitos fraccionarios distintos de cero.s includes non-zero, fractional digits.

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

O bien-or- style no es una combinación de valores AllowHexSpecifier y HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Ejemplos

En el ejemplo siguiente se analizan las representaciones de cadena de Byte valores con el método Byte.Parse(String, NumberStyles).The following example parses string representations of Byte values with the Byte.Parse(String, NumberStyles) method. La referencia cultural actual para el ejemplo es en-US.The current culture for the example is 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.
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.            
Dim value As String
Dim style As NumberStyles
Dim number As Byte

' 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 e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try
  
' Parse value with trailing sign.
style = NumberStyles.Integer Or 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.            

Comentarios

El parámetro style define los elementos de estilo (como el espacio 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.The style parameter defines the style elements (such as white space or the positive sign) that are allowed in the s parameter for the parse operation to succeed. Debe ser una combinación de marcas de bits de la enumeración NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. Dependiendo del valor de style, el parámetro s puede incluir los siguientes elementos:Depending on the value of style, the s parameter may include the following elements:

[ws][$][sign]digits[.fractional_digits][e[sign]digits][ws][ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]

O bien, si style incluye AllowHexSpecifier:Or, if style includes AllowHexSpecifier:

[ws] hexdigits [ws][ws]hexdigits[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 marca NumberStyles.AllowLeadingWhite o al final de s si Style incluye la marca NumberStyles.AllowTrailingWhite.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or 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. La propiedad NumberFormatInfo.CurrencyPositivePattern de la referencia cultural actual define su posición en la cadena.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the current culture. El símbolo de divisa de la referencia cultural actual puede aparecer en s si style incluye la marca NumberStyles.AllowCurrencySymbol.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Un signo positivo opcional.An optional positive sign. (El método produce una OverflowException si hay un signo negativo 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.(The method throws an OverflowException if a negative sign is present in s.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, or at the end of s if style includes the NumberStyles.AllowTrailingSign flag.
digitsdigits Secuencia de dígitos del 0 al 9.A sequence of digits from 0 through 9.
.. 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 marca NumberStyles.AllowDecimalPoint.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Una o más apariciones del dígito 0.One or more occurrences of the digit 0. Los dígitos fraccionarios solo pueden aparecer en s si style incluye la marca NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee El carácter e o E, que indica que el valor se representa en notación exponencial.The e or E character, which indicates that the value is represented in exponential notation. El parámetro s puede representar un número en notación exponencial si style incluye la marca NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Secuencia de dígitos hexadecimales de 0 a f, o de 0 a F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Nota

La operación de análisis omite los caracteres NUL (U + 0000) de terminación de s, independientemente del valor del argumento style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Una cadena con dígitos decimales únicamente (que corresponde al estilo NumberStyles.None) siempre se analiza correctamente.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. La mayoría de los miembros de la NumberStyles restantes controlan los elementos que pueden estar presentes en esta cadena de entrada, pero que no son necesarios.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. En la tabla siguiente se indica cómo los miembros de NumberStyles individuales afectan a los elementos que pueden estar presentes en s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valores NumberStyles no compuestosNon-composite NumberStyles values Elementos permitidos en s además de dígitosElements permitted in s in addition to digits
NumberStyles.None Solo dígitos decimales.Decimal digits only.
NumberStyles.AllowDecimalPoint El elemento de lenguaje .The . y fractional_digits elementos.and fractional_digits elements. Sin embargo, fractional_digits debe constar solo de uno o más dígitos 0 o se produce una OverflowException.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent El parámetro s también puede usar la notación exponencial.The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite Elemento WS al principio de s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Elemento WS al final de s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Un signo positivo puede aparecer antes que los dígitos.A positive sign can appear before digits.
NumberStyles.AllowTrailingSign Un signo positivo puede aparecer después de los dígitos.A positive sign can appear after digits.
NumberStyles.AllowParentheses Aunque se admite esta marca, el uso de paréntesis en s da como resultado un OverflowException.Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands Aunque el símbolo de separador de grupos puede aparecer en s, solo puede ir precedido de uno o más dígitos 0.Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol El elemento $ .The $ element.

Si se usa la marca NumberStyles.AllowHexSpecifier, s debe ser un valor hexadecimal sin prefijo.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Por ejemplo, "F3" se analiza correctamente, pero "0xF3" no lo hace.For example, "F3" parses successfully, but "0xF3" does not. Las demás marcas que se pueden combinar con ella son NumberStyles.AllowLeadingWhite y NumberStyles.AllowTrailingWhite.The only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (La enumeración NumberStyles incluye un estilo de número compuesto, NumberStyles.HexNumber, que incluye ambas marcas de espacio en blanco).(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

El parámetro s se analiza utilizando la información de formato de un objeto NumberFormatInfo 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 utilizar la información de formato de alguna otra referencia cultural, llame a la sobrecarga Byte.Parse(String, NumberStyles, IFormatProvider).To use the formatting information of some other culture, call the Byte.Parse(String, NumberStyles, IFormatProvider) overload.

Consulte también:

Parse(String)

Convierte la representación en forma de cadena de un número en su Byte equivalente.Converts the string representation of a number to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s);
public static byte Parse (string s);
static member Parse : string -> byte
Public Shared Function Parse (s As String) As Byte

Parámetros

s
String

Cadena que contiene un número que se va a convertir.A string that contains a number to convert. La cadena se interpreta usando el estilo Integer.The string is interpreted using the Integer style.

Devoluciones

Un valor de byte que es equivalente al número contenido en s.A byte value that is equivalent to the number contained in s.

Excepciones

s es null.s is null.

s no tiene el formato correcto.s is not of the correct format.

s representa un número menor que MinValue o mayor que MaxValue.s represents a number less than MinValue or greater than MaxValue.

Ejemplos

En el ejemplo siguiente se muestra cómo convertir un valor de cadena en un valor de byte mediante el método Byte.Parse(String).The following example demonstrates how to convert a string value into a byte value using the Byte.Parse(String) method. A continuación, el valor de byte resultante se muestra en la consola.The resulting byte value is then displayed to the console.

String^ stringToConvert = " 162";
Byte byteValue;
try
{
   byteValue = Byte::Parse(stringToConvert);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}   
catch (FormatException^)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException^)
{
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue);
}  
// The example displays the following output to the console:
//       Converted ' 162' to 162.         
string stringToConvert = " 162";
byte byteValue;
try
{
   byteValue = Byte.Parse(stringToConvert);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}   
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte.MaxValue, Byte.MinValue);
}  
// The example displays the following output to the console:
//       Converted ' 162' to 162.         
Dim stringToConvert As String = " 162"
Dim byteValue As Byte
Try
   byteValue = Byte.Parse(stringToConvert)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  
' The example displays the following output to the console:
'       Converted ' 162' to 162.         

Comentarios

El parámetro s contiene un número de la forma:The s parameter contains a number of the form:

WS [signo] dígitos [ws][ws][sign]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.
signsign Signo positivo o negativo opcional.An optional positive or negative sign.
digitsdigits Secuencia de dígitos que comprende del 0 al 9.A sequence of digits ranging from 0 to 9.

El parámetro s se interpreta utilizando el estilo de NumberStyles.Integer.The s parameter is interpreted using the NumberStyles.Integer style. Además de los dígitos decimales del valor de byte, solo se permiten los espacios iniciales y finales junto con un signo inicial.In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (Si el signo está presente, debe ser un signo positivo o el método produce una OverflowException). Para definir explícitamente los elementos de estilo que pueden estar presentes en s, use el método Byte.Parse(String, NumberStyles) o Byte.Parse(String, NumberStyles, IFormatProvider).(If the sign is present, it must be a positive sign or the method throws an OverflowException.) To explicitly define the style elements that can be present in s, use either the Byte.Parse(String, NumberStyles) or the Byte.Parse(String, NumberStyles, IFormatProvider) method.

El parámetro s se analiza utilizando la información de formato de un objeto NumberFormatInfo 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 más información, consulte CurrentInfo.For more information, see CurrentInfo. Para analizar una cadena utilizando la información de formato de alguna otra referencia cultural, utilice el método Byte.Parse(String, NumberStyles, IFormatProvider).To parse a string using the formatting information of some other culture, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.

Consulte también:

Parse(String, IFormatProvider)

Convierte la representación en forma de cadena de un número con el formato específico de la referencia cultural indicada en su Byte equivalente.Converts the string representation of a number in a specified culture-specific format to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider);
public static byte Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> byte
Public Shared Function Parse (s As String, provider As IFormatProvider) As Byte

Parámetros

s
String

Cadena que contiene un número que se va a convertir.A string that contains a number to convert. La cadena se interpreta usando el estilo Integer.The string is interpreted using the Integer style.

provider
IFormatProvider

Un objeto que proporciona información de análisis específica de la referencia cultural sobre s.An object that supplies culture-specific parsing information about s. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Devoluciones

Un valor de byte que es equivalente al número contenido en s.A byte value that is equivalent to the number contained in s.

Excepciones

s es null.s is null.

s no tiene el formato correcto.s is not of the correct format.

s representa un número menor que MinValue o mayor que MaxValue.s represents a number less than MinValue or greater than MaxValue.

Ejemplos

En el ejemplo siguiente se analizan las representaciones de cadena de Byte valores con el método Parse.The following example parses string representations of Byte values with the Parse method.

String^ stringToConvert; 
Byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException^) {
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException^) {
   Console::WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte::MaxValue, Byte::MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.
string stringToConvert; 
byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", 
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.
Dim stringToConvert As String 
Dim byteValue As Byte

stringToConvert = " 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " + 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " +214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214 '.
'       Converted ' +214 ' to 214.

Comentarios

El parámetro s contiene un número de la forma:The s parameter contains a number of the form:

WS [signo] dígitos [ws][ws][sign]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.
signsign Un signo positivo opcional.An optional positive sign.
digitsdigits Secuencia de dígitos que comprende del 0 al 9.A sequence of digits ranging from 0 to 9.

El parámetro s se interpreta utilizando el estilo de Integer.The s parameter is interpreted using the Integer style. Además de los dígitos decimales del valor de byte, solo se permiten los espacios iniciales y finales junto con un signo inicial.In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (Si el signo está presente, debe ser un signo positivo o el método produce una OverflowException). Para definir explícitamente los elementos de estilo junto con la información de formato específica de la referencia cultural que puede estar presente en s, use el método Byte.Parse(String, NumberStyles, IFormatProvider).(If the sign is present, it must be a positive sign or the method throws an OverflowException.) To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.

El parámetro s se analiza utilizando la información de formato en un objeto NumberFormatInfo proporcionado por provider.The s parameter is parsed using the formatting information in a NumberFormatInfo object supplied by provider. El parámetro provider es una implementación de IFormatProvider como un objeto NumberFormatInfo o CultureInfo.The provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. El parámetro provider proporciona información específica de la referencia cultural que se usa en el análisis.The provider parameter supplies culture-specific information used in parsing. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Consulte también:

Se aplica a