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

Definice

Převede řetězcové vyjádření čísla na jeho Byte ekvivalent.Converts the string representation of a number to its Byte equivalent.

Přetížení

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Převede řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho Byte ekvivalent.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)

Převede řetězcové vyjádření čísla v zadaném stylu na jeho Byte ekvivalent.Converts the string representation of a number in a specified style to its Byte equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

Převede řetězcové vyjádření čísla na jeho Byte ekvivalent.Converts the string representation of a number to its Byte equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Převede řetězcové vyjádření čísla v zadaném formátu specifickém pro jazykovou verzi na jeho Byte ekvivalent.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)

Převede řetězcové vyjádření čísla v zadaném stylu a formátu specifického pro jazykovou verzi na jeho Byte ekvivalent.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

Parametry

s
String String String String

Řetězec obsahující číslo k převedení.A string that contains a number to convert. Řetězec je interpretován pomocí stylu určeného parametrem style.The string is interpreted using the style specified by style.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Bitová kombinace hodnot výčtu, která určuje prvky stylu, které mohou být přítomny sv.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Typická hodnota, která se má Integerzadat, je.A typical value to specify is Integer.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objekt, který poskytuje informace specifické pro jazykovou verzi o formátu s.An object that supplies culture-specific information about the format of s. Pokud provider jenull, použije se aktuální jazyková verze vlákna.If provider is null, the thread current culture is used.

Návraty

Bajtová hodnota, která odpovídá číslu obsaženému v s.A byte value that is equivalent to the number contained in s.

Výjimky

snemá správný formát.s is not of the correct format.

spředstavuje číslo menší MinValue nebo MaxValuerovno.s represents a number less than MinValue or greater than MaxValue.

-nebo--or- szahrnuje nenulové a zlomkové číslice.s includes non-zero, fractional digits.

styleNumberStyles není hodnota.style is not a NumberStyles value.

-nebo--or- stylenení kombinací AllowHexSpecifier hodnot a HexNumber .style is not a combination of AllowHexSpecifier and HexNumber values.

Příklady

Následující příklad kódu analyzuje řetězcové reprezentace Byte hodnot s tímto přetížením Byte.Parse(String, NumberStyles, IFormatProvider) metody.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.

Poznámky

Parametr definuje prvky stylu (například prázdné znaky nebo kladné znaménko), které jsou povoleny s v parametru pro úspěšné provedení operace analýzy. styleThe 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. Musí být kombinací bitových příznaků od NumberStyles výčtu.It must be a combination of bit flags from the NumberStyles enumeration. V závislosti na hodnotě style s může parametr obsahovat následující prvky: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]

Nebo, pokud style parametr obsahuje AllowHexSpecifier:Or, if the style parameter includes AllowHexSpecifier:

[ws]hexdigits[ws][ws]hexdigits[ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space. Mezera se může s objevit na začátku if, pokud style obsahuje NumberStyles.AllowLeadingWhite příznak, NumberStyles.AllowTrailingWhite nebo na konci s , pokud style obsahuje příznak.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.
$ Symbol měny pro konkrétní jazykovou verzi.A culture-specific currency symbol. Jeho pozice v řetězci je NumberFormatInfo.CurrencyPositivePattern definována vlastností NumberFormatInfo objektu vráceného GetFormat metodou provider parametru.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. Symbol měny se může objevit v s části style if obsahuje NumberStyles.AllowCurrencySymbol příznak.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Volitelné kladné znaménko.An optional positive sign. (Metoda vyvolá výjimku OverflowException , pokud je k sdispozici záporné znaménko.) Znaménko se může zobrazit s na začátku, pokud style obsahuje NumberStyles.AllowLeadingSign příznak, NumberStyles.AllowTrailingSign nebo na konci s , pokud style obsahuje příznak.(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.
znakdigits Řada číslic od 0 do 9.A sequence of digits from 0 through 9.
.. Symbol desetinné čárky specifický pro jazykovou verzi.A culture-specific decimal point symbol. Symbol desetinné čárky jazykové verze určený parametrem provider se může objevit s v style části NumberStyles.AllowDecimalPoint if obsahuje příznak.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Jeden nebo více výskytů číslice 0.One or more occurrences of the digit 0. Zlomkové číslice se mohou objevit s pouze v style případě, NumberStyles.AllowDecimalPoint že obsahuje příznak.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee Znak e nebo E, který označuje, že hodnota je reprezentována exponenciálním zápisem.The e or E character, which indicates that the value is represented in exponential notation. Parametr s může představovat číslo v exponenciálním zápisu, pokud style NumberStyles.AllowExponent obsahuje příznak.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Posloupnost šestnáctkových číslic od 0 do f nebo id 0 do F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Poznámka

Všechny ukončující znaky NUL (U + 0000) v s jsou ignorovány operací analýzy bez ohledu na hodnotu style argumentu.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Řetězec s pouze desítkovými číslicemi (který odpovídá NumberStyles.None stylu) se vždy analyzuje úspěšně.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. Většina zbývajících NumberStyles členů řídí prvky, které mohou být ale v tomto vstupním řetězci nemusejí být přítomny.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. Následující tabulka uvádí, jak jednotlivé NumberStyles členy ovlivňují prvky, které mohou být přítomny sv.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Nesložené hodnoty NumberStylesNon-composite NumberStyles values Prvky, které jsou povoleny v s, kromě číslicElements permitted in s in addition to digits
NumberStyles.None Pouze desítkové číslice.Decimal digits only.
NumberStyles.AllowDecimalPoint Rozhraní .The . a fractional_digits elementy.and fractional_digits elements. Fractional_digits však musí obsahovat pouze jednu nebo více číslic 0 nebo OverflowException je vyvolána.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent s Parametr může také používat exponenciální zápis.The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite Element WS na začátku s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Element WS na konci s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Před číslicemi se může zobrazit ** kladné znaménko.A positive sign can appear before digits.
NumberStyles.AllowTrailingSign Za číslicemi se může zobrazit ** kladné znaménko.A positive sign can appear after digits.
NumberStyles.AllowParentheses I když je tento příznak podporován, použití závorek ve s výsledku OverflowExceptionv.Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands I když se symbol oddělovače skupiny může szobrazit v, může předcházet jenom jedna nebo víc číslic 0.Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol $ Elementu.The $ element.

Pokud se použije spříznak, musí být hexadecimální hodnota bez předpony. NumberStyles.AllowHexSpecifierIf the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Například "F3" se úspěšně analyzuje, ale "0xF3".For example, "F3" parses successfully, but "0xF3" does not. Jediné další příznaky, které mohou být přítomny style v NumberStyles.AllowLeadingWhite nástroji NumberStyles.AllowTrailingWhite, jsou a.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Výčet má složený styl čísla, NumberStyles.HexNumber, který obsahuje oba příznaky prázdné znaky.) NumberStyles(The NumberStyles enumeration has a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

Parametr je CultureInfo implementace, jako je například objekt nebo.NumberFormatInfo IFormatProvider providerThe provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. provider Parametr poskytuje informace specifické pro jazykovou verzi používané při analýze.The provider parameter supplies culture-specific information used in parsing. Pokud provider jenull, použije se aktuální jazyková verze vlákna.If provider is null, the thread current culture is used.

Viz také

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

Parametry

Návraty

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Převede řetězcové vyjádření čísla v zadaném stylu na jeho Byte ekvivalent.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

Parametry

s
String String String String

Řetězec obsahující číslo k převedení.A string that contains a number to convert. Řetězec je interpretován pomocí stylu určeného parametrem style.The string is interpreted using the style specified by style.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Bitová kombinace hodnot výčtu, která určuje prvky stylu, které mohou být přítomny sv.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Typická hodnota, která se má Integerzadat, je.A typical value to specify is Integer.

Návraty

Bajtová hodnota, která odpovídá číslu obsaženému v s.A byte value that is equivalent to the number contained in s.

Výjimky

snemá správný formát.s is not of the correct format.

spředstavuje číslo menší MinValue nebo MaxValuerovno.s represents a number less than MinValue or greater than MaxValue.

-nebo--or- szahrnuje nenulové a zlomkové číslice.s includes non-zero, fractional digits.

styleNumberStyles není hodnota.style is not a NumberStyles value.

-nebo--or- stylenení kombinací AllowHexSpecifier hodnot a HexNumber .style is not a combination of AllowHexSpecifier and HexNumber values.

Příklady

Následující příklad analyzuje řetězcové reprezentace Byte hodnot Byte.Parse(String, NumberStyles) pomocí metody.The following example parses string representations of Byte values with the Byte.Parse(String, NumberStyles) method. Aktuální jazyková verze pro daný příklad je 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.            

Poznámky

Parametr definuje prvky stylu (například prázdné znaky nebo kladné znaménko), které jsou povoleny s v parametru pro úspěšné provedení operace analýzy. styleThe 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. Musí být kombinací bitových příznaků od NumberStyles výčtu.It must be a combination of bit flags from the NumberStyles enumeration. V závislosti na hodnotě style s může parametr obsahovat následující prvky: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]

Nebo, pokud style obsahuje AllowHexSpecifier:Or, if style includes AllowHexSpecifier:

[ws]hexdigits[ws][ws]hexdigits[ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space. Prázdné znaky mohou být s zobrazeny na začátku, pokud style obsahuje NumberStyles.AllowLeadingWhite příznak nebo na konci s, pokud style obsahuje NumberStyles.AllowTrailingWhite příznak.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.
$ Symbol měny pro konkrétní jazykovou verzi.A culture-specific currency symbol. Jeho pozice v řetězci je definována NumberFormatInfo.CurrencyPositivePattern vlastností aktuální jazykové verze.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the current culture. Symbol měny aktuální jazykové verze se může objevit v s části style if obsahuje NumberStyles.AllowCurrencySymbol příznak.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Volitelné kladné znaménko.An optional positive sign. (Metoda vyvolá výjimku OverflowException , pokud je k sdispozici záporné znaménko.) Znaménko se může zobrazit s na začátku, pokud style obsahuje NumberStyles.AllowLeadingSign příznak, NumberStyles.AllowTrailingSign nebo na konci s , pokud style obsahuje příznak.(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.
znakdigits Řada číslic od 0 do 9.A sequence of digits from 0 through 9.
.. Symbol desetinné čárky specifický pro jazykovou verzi.A culture-specific decimal point symbol. Symbol desetinné čárky aktuální jazykové verze se může objevit s v style , pokud NumberStyles.AllowDecimalPoint obsahuje příznak.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Jeden nebo více výskytů číslice 0.One or more occurrences of the digit 0. Zlomkové číslice se mohou objevit s pouze v style případě, NumberStyles.AllowDecimalPoint že obsahuje příznak.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee Znak e nebo E, který označuje, že hodnota je reprezentována exponenciálním zápisem.The e or E character, which indicates that the value is represented in exponential notation. Parametr může představovat číslo v exponenciálním zápisu, pokud style obsahuje NumberStyles.AllowExponent příznak. sThe s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Posloupnost šestnáctkových číslic od 0 do f nebo id 0 do F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Poznámka

Všechny ukončující znaky NUL (U + 0000) v s jsou ignorovány operací analýzy bez ohledu na hodnotu style argumentu.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Řetězec s pouze desítkovými číslicemi (který odpovídá NumberStyles.None stylu) se vždy analyzuje úspěšně.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. Většina zbývajících NumberStyles členů řídí prvky, které mohou být ale v tomto vstupním řetězci nemusejí být přítomny.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. Následující tabulka uvádí, jak jednotlivé NumberStyles členy ovlivňují prvky, které mohou být přítomny sv.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Nesložené hodnoty NumberStylesNon-composite NumberStyles values Prvky, které jsou povoleny v s, kromě číslicElements permitted in s in addition to digits
NumberStyles.None Pouze desítkové číslice.Decimal digits only.
NumberStyles.AllowDecimalPoint Rozhraní .The . a fractional_digits elementy.and fractional_digits elements. Fractional_digits však musí obsahovat pouze jednu nebo více číslic 0 nebo OverflowException je vyvolána.However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent s Parametr může také používat exponenciální zápis.The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite Element WS na začátku s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Element WS na konci s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Před číslicemi se může zobrazit ** kladné znaménko.A positive sign can appear before digits.
NumberStyles.AllowTrailingSign Za číslicemi se může zobrazit ** kladné znaménko.A positive sign can appear after digits.
NumberStyles.AllowParentheses I když je tento příznak podporován, použití závorek ve s výsledku OverflowExceptionv.Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands I když se symbol oddělovače skupiny může szobrazit v, může předcházet jenom jedna nebo víc číslic 0.Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol $ Elementu.The $ element.

Pokud se použije spříznak, musí být hexadecimální hodnota bez předpony. NumberStyles.AllowHexSpecifierIf the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Například "F3" se úspěšně analyzuje, ale "0xF3".For example, "F3" parses successfully, but "0xF3" does not. Jedinými ostatními příznaky, které lze kombinovat, jsou NumberStyles.AllowLeadingWhite a. NumberStyles.AllowTrailingWhiteThe only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Výčet obsahuje složený styl čísla, NumberStyles.HexNumber, který obsahuje oba příznaky prázdné znaky.) NumberStyles(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

Parametr je analyzován pomocí informací o formátování NumberFormatInfo v objektu, který je inicializován pro aktuální jazykovou verzi systému. sThe s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Chcete-li použít informace o formátování některé jiné jazykové verze, Byte.Parse(String, NumberStyles, IFormatProvider) zavolejte přetížení.To use the formatting information of some other culture, call the Byte.Parse(String, NumberStyles, IFormatProvider) overload.

Viz také

Parse(String) Parse(String) Parse(String) Parse(String)

Převede řetězcové vyjádření čísla na jeho Byte ekvivalent.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

Parametry

s
String String String String

Řetězec obsahující číslo k převedení.A string that contains a number to convert. Řetězec je interpretován pomocí Integer stylu.The string is interpreted using the Integer style.

Návraty

Bajtová hodnota, která odpovídá číslu obsaženému v s.A byte value that is equivalent to the number contained in s.

Výjimky

snemá správný formát.s is not of the correct format.

spředstavuje číslo menší MinValue nebo MaxValuerovno.s represents a number less than MinValue or greater than MaxValue.

Příklady

Následující příklad ukazuje, jak převést řetězcovou hodnotu na hodnotu Byte pomocí Byte.Parse(String) metody.The following example demonstrates how to convert a string value into a byte value using the Byte.Parse(String) method. Výsledná bajtová hodnota se pak zobrazí v konzole nástroje.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.         

Poznámky

s Parametr obsahuje číslo formuláře:The s parameter contains a number of the form:

[ws][sign]digits[ws][ws][sign]digits[ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space.
signsign Volitelné kladné nebo záporné znaménko.An optional positive or negative sign.
znakdigits Řada číslic od 0 do 9.A sequence of digits ranging from 0 to 9.

Parametr je interpretován NumberStyles.Integer pomocí stylu. sThe s parameter is interpreted using the NumberStyles.Integer style. Kromě desetinných číslic hodnoty Byte jsou povoleny pouze úvodní a koncové mezery spolu s počátečním znaménkem.In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (Pokud je k dispozici znaménko, musí se jednat o kladné znaménko nebo metoda OverflowExceptionvyvolá.) Chcete-li explicitně definovat prvky stylu, které mohou být spřítomny v, Byte.Parse(String, NumberStyles) použijte buď Byte.Parse(String, NumberStyles, IFormatProvider) metodu, nebo.(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.

Parametr je analyzován pomocí informací o formátování NumberFormatInfo v objektu, který je inicializován pro aktuální jazykovou verzi systému. sThe s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Další informace naleznete v tématu CurrentInfo.For more information, see CurrentInfo. Chcete-li analyzovat řetězec pomocí informací o formátování některé jiné jazykové verze, použijte Byte.Parse(String, NumberStyles, IFormatProvider) metodu.To parse a string using the formatting information of some other culture, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.

Viz také

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Převede řetězcové vyjádření čísla v zadaném formátu specifickém pro jazykovou verzi na jeho Byte ekvivalent.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

Parametry

s
String String String String

Řetězec obsahující číslo k převedení.A string that contains a number to convert. Řetězec je interpretován pomocí Integer stylu.The string is interpreted using the Integer style.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objekt, který poskytuje informace o sanalýze specifické pro jazykovou verzi.An object that supplies culture-specific parsing information about s. Pokud provider jenull, použije se aktuální jazyková verze vlákna.If provider is null, the thread current culture is used.

Návraty

Bajtová hodnota, která odpovídá číslu obsaženému v s.A byte value that is equivalent to the number contained in s.

Výjimky

snemá správný formát.s is not of the correct format.

spředstavuje číslo menší MinValue nebo MaxValuerovno.s represents a number less than MinValue or greater than MaxValue.

Příklady

Následující příklad analyzuje řetězcové reprezentace Byte hodnot Parse pomocí metody.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.

Poznámky

s Parametr obsahuje číslo formuláře:The s parameter contains a number of the form:

[ws][sign]digits[ws][ws][sign]digits[ws]

Prvky v hranatých závorkách ([a]) jsou volitelné.Elements in square brackets ([ and ]) are optional. Následující tabulka popisuje jednotlivé prvky.The following table describes each element.

PrvekElement PopisDescription
wsws Volitelné prázdné místo.Optional white space.
signsign Volitelné kladné znaménko.An optional positive sign.
znakdigits Řada číslic od 0 do 9.A sequence of digits ranging from 0 to 9.

Parametr je interpretován Integer pomocí stylu. sThe s parameter is interpreted using the Integer style. Kromě desetinných číslic hodnoty Byte jsou povoleny pouze úvodní a koncové mezery spolu s počátečním znaménkem.In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (Pokud je k dispozici znaménko, musí se jednat o kladné znaménko nebo metoda OverflowExceptionvyvolá.) Chcete-li explicitně definovat prvky stylu společně s informacemi o formátování specifické jazykové verze, které mohou být sk dispozici Byte.Parse(String, NumberStyles, IFormatProvider) v, použijte metodu.(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.

Parametr je analyzován pomocí informací o formátování NumberFormatInfo v objektu provider, který poskytuje. sThe s parameter is parsed using the formatting information in a NumberFormatInfo object supplied by provider. Parametr je implementace, jako je CultureInfo například objekt nebo.NumberFormatInfo IFormatProvider providerThe provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. provider Parametr poskytuje informace specifické pro jazykovou verzi používané při analýze.The provider parameter supplies culture-specific information used in parsing. Pokud provider jenull, použije se aktuální jazyková verze vlákna.If provider is null, the thread current culture is used.

Viz také

Platí pro