Byte.Parse Byte.Parse Byte.Parse Byte.Parse Method

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) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) 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) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) 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) Parse(String) Parse(String) 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) Parse(String, IFormatProvider) Parse(String, IFormatProvider) 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) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) 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 String String 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 NumberStyles NumberStyles 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 IFormatProvider IFormatProvider 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 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 Byte las representaciones de cadena de los Byte.Parse(String, NumberStyles, IFormatProvider) valores con esta sobrecarga del método.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 style parámetro define los elementos de estilo (como el espacio en blanco o el signo positivo) que se permiten s en el parámetro 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 NumberStyles enumeración.It must be a combination of bit flags from the NumberStyles enumeration. Dependiendo del valor de style, el s parámetro 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 el parámetro AllowHexSpecifierincluye: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 s de style si incluye NumberStyles.AllowLeadingWhite la marca o al final de s si style incluye la NumberStyles.AllowTrailingWhite marca.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 NumberFormatInfo.CurrencyPositivePattern propiedad GetFormat del objeto devuelto por el método del parámetrodefinesuposiciónenlacadena.provider NumberFormatInfoIts 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 s en style si incluye NumberStyles.AllowCurrencySymbol la marca.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 excepción si hay un signo negativo en 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.(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 provider referencia cultural especificada s por puede aparecer NumberStyles.AllowDecimalPoint en si style incluye la marca.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 s aparecer en style si incluye NumberStyles.AllowDecimalPoint la marca.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 NumberStyles.AllowExponent marca.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

Los caracteres NUL de terminación (U + 0000) s de se omiten en la operación de análisis, independientemente del valor style del 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 con dígitos decimales solamente (que corresponde NumberStyles.None al estilo) 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 NumberStyles miembros 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 NumberStyles cómo afectan los miembros individuales a los elementos que spueden estar presentes en.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 los elementos dígitos fraccionarios .and fractional_digits elements. Sin embargo, los dígitos fraccionarios deben constar solo de uno o OverflowException más dígitos 0 o se produce una excepción.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent El s parámetro 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 produce una. OverflowExceptionAlthough this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands Aunque el símbolo de separador de grupos spuede aparecer en, 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 $ Elemento.The $ element.

Si se NumberStyles.AllowHexSpecifier usa la marca, s debe ser un valor hexadecimal sin un 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 NumberStyles enumeración tiene un estilo de número NumberStyles.HexNumbercompuesto,, 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 provider parámetro es una IFormatProvider implementación de, como un NumberFormatInfo objeto CultureInfo o.The provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. El provider parámetro 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) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

public static byte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
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

Devoluciones

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) 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 String String 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 NumberStyles NumberStyles 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 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 siguiente ejemplo se analizan las Byte representaciones de cadena Byte.Parse(String, NumberStyles) de los valores con el método.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 style parámetro define los elementos de estilo (como el espacio en blanco o el signo positivo) que se permiten s en el parámetro 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 NumberStyles enumeración.It must be a combination of bit flags from the NumberStyles enumeration. Dependiendo del valor de style, el s parámetro 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, style si AllowHexSpecifierincluye: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 s de style si incluye NumberStyles.AllowLeadingWhite la marca, o al final de s si Style incluye la NumberStyles.AllowTrailingWhite marca.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 NumberFormatInfo.CurrencyPositivePattern propiedad 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 s puede style aparecer en NumberStyles.AllowCurrencySymbol si incluye la marca.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 excepción si hay un signo negativo en 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.(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 s cultural style actual puede NumberStyles.AllowDecimalPoint aparecer en si incluye la marca.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 s aparecer en style si incluye NumberStyles.AllowDecimalPoint la marca.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 s parámetro puede representar un número en notación exponencial si style incluye la NumberStyles.AllowExponent marca.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

Los caracteres NUL de terminación (U + 0000) s de se omiten en la operación de análisis, independientemente del valor style del 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 con dígitos decimales solamente (que corresponde NumberStyles.None al estilo) 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 NumberStyles miembros 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 NumberStyles cómo afectan los miembros individuales a los elementos que spueden estar presentes en.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 los elementos dígitos fraccionarios .and fractional_digits elements. Sin embargo, los dígitos fraccionarios deben constar solo de uno o OverflowException más dígitos 0 o se produce una excepción.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent El s parámetro 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 produce una. OverflowExceptionAlthough this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands Aunque el símbolo de separador de grupos spuede aparecer en, 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 $ Elemento.The $ element.

Si se NumberStyles.AllowHexSpecifier usa la marca, s debe ser un valor hexadecimal sin un 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 él son NumberStyles.AllowLeadingWhite y. NumberStyles.AllowTrailingWhiteThe only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (La NumberStyles enumeración incluye un estilo de número NumberStyles.HexNumbercompuesto,, 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 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 utilizar la información de formato de alguna otra referencia cultural, Byte.Parse(String, NumberStyles, IFormatProvider) llame a la sobrecarga.To use the formatting information of some other culture, call the Byte.Parse(String, NumberStyles, IFormatProvider) overload.

Consulte también:

Parse(String) Parse(String) Parse(String) 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 String String 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 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.Parse(String) Byte mediante el método.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 s parámetro 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 s parámetro se interpreta utilizando el NumberStyles.Integer estilo.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 OverflowExceptionexcepción). Para definir explícitamente los elementos de estilo que pueden estar spresentes en, use Byte.Parse(String, NumberStyles) el Byte.Parse(String, NumberStyles, IFormatProvider) método o.(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 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 CurrentInfo.For more information, see CurrentInfo. Para analizar una cadena utilizando la información de formato de alguna otra referencia cultural, Byte.Parse(String, NumberStyles, IFormatProvider) use el método.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) Parse(String, IFormatProvider) Parse(String, IFormatProvider) 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 String String 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 IFormatProvider IFormatProvider 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 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 siguiente ejemplo se analizan las Byte representaciones de cadena Parse de los valores con el método.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 s parámetro 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 s parámetro se interpreta utilizando el Integer estilo.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 OverflowExceptionexcepción). Para definir explícitamente los elementos de estilo junto con la información de formato específica de la referencia cultural sque puede estar Byte.Parse(String, NumberStyles, IFormatProvider) presente en, use el método.(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 s parámetro se analiza utilizando la información de formato de un NumberFormatInfo objeto proporcionado por provider.The s parameter is parsed using the formatting information in a NumberFormatInfo object supplied by provider. El provider parámetro es una IFormatProvider implementación como un NumberFormatInfo objeto o CultureInfo .The provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. El provider parámetro 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