Tento článek byl přeložený strojově. Pokud chcete zobrazit článek v angličtině, zaškrtněte políčko Angličtina. Anglickou verzi článku můžete také zobrazit v místním okně přesunutím ukazatele myši nad text.
Překlad
Angličtina

Metoda Byte.Parse (String, NumberStyles, IFormatProvider)

.NET Framework (current version)
 

Převádí řetězcové vyjádření čísla v zadaném stylu a formátu specifické pro jazykovou verzi, aby jeho Byte ekvivalentní.

Obor názvů:   System
Sestavení:  mscorlib (v mscorlib.dll)

public static byte Parse(
	string s,
	NumberStyles style,
	IFormatProvider provider
)

Parametry

s
Type: System.String

Řetězec obsahující číslo k převedení. Řetězec je interpretován pomocí stylu určeného parametrem style.

style
Type: System.Globalization.NumberStyles

Bitová kombinace hodnot výčtu označující prvky stylu, které mohou být přítomny v s. Obvyklé hodnoty k určení NumberStyles.Integer.

provider
Type: System.IFormatProvider

Objekt, který poskytuje informace specifické jazykové verze o formátu s. Pokud provider je null, používá aktuální jazykové verzi vlákna.

Návratová hodnota

Type: System.Byte

Bajtová hodnota, která je ekvivalentní číslo obsažené v s.

Exception Condition
ArgumentNullException

s je null.

FormatException

s není ve správném formátu.

OverflowException

s představuje číslo menší než Byte.MinValue nebo větší než Byte.MaxValue.

- nebo -

s obsahuje nenulové zlomkové číslice.

ArgumentException

style není NumberStyles hodnotu.

- nebo -

style není kombinace NumberStyles.AllowHexSpecifier a NumberStyles.HexNumber hodnoty.

style Parametr definuje prvky stylu (například mezery nebo kladné znaménko), které jsou povoleny v s parametr pro operace analýzy proběhla úspěšně. Musí být kombinací bitové příznaky z NumberStyles výčtu. V závislosti na hodnotu style, s parametru může obsahovat následující prvky:

[ws] [$] číslice [znak] [.fractional_digits] [číslic e [znak]] [ws]

Nebo, pokud style parametr zahrnuje AllowHexSpecifier:

[ws] hexdigits [ws]

Prvky v hranatých závorkách ([a]) jsou volitelné. Následující tabulka popisuje jednotlivé prvky.

Prvek

Popis

ws

Volitelné prázdné místo. Prázdné znaky se mohou objevit na začátku s Pokud style zahrnuje NumberStyles.AllowLeadingWhite příznak, nebo na konci s Pokud style zahrnuje NumberStyles.AllowTrailingWhite příznak.

$

Symbol měny specifické pro jazykovou verzi. Jeho pozice v řetězci je definována NumberFormatInfo.CurrencyPositivePattern vlastnost NumberFormatInfo objektu vráceného GetFormat metodu provider parametr. Symbol měny se mohou objevit v s Pokud style zahrnuje NumberStyles.AllowCurrencySymbol příznak.

znaménko

Volitelné kladné znaménko. (Metoda vyvolá OverflowException Pokud je k dispozici v záporné znaménko s.) Znaménko se může objevit na začátku s Pokud style zahrnuje NumberStyles.AllowLeadingSign příznak, nebo na konci s Pokud style zahrnuje NumberStyles.AllowTrailingSign příznak.

číslice

Posloupnost číslic od 0 do 9.

.

Symbol desetinné čárky specifické pro jazykovou verzi. Symbol desetinné čárky jazykové verze určený podle provider se mohou objevit v s Pokud style zahrnuje NumberStyles.AllowDecimalPoint příznak.

fractional_digits

Jeden nebo více výskytů číslice 0. Zlomkové číslice se mohou objevit v s pouze tehdy, pokud style zahrnuje NumberStyles.AllowDecimalPoint příznak.

e

E nebo E znak, který označuje, že hodnota je vyjádřena v exponenciální notaci. Parametr s může představovat číslo v exponenciální notaci, pokud style zahrnuje NumberStyles.AllowExponent příznak.

hexdigits

Posloupnost šestnáctkových číslic od 0 do f nebo ID 0 do F.

Řetězec pouze s desítkovými číslicemi (který odpovídá NumberStyles.None styl) vždy analyzuje úspěšně. Většina ze zbývajících NumberStyles ovládacích prvků, které mohou být ale nemusejí být k dispozici v tomto vstupním řetězci členů. Následující tabulka udává, jak jednotlivé NumberStyles členy ovlivňují prvky, které mohou být přítomny v s.

Nesložené hodnoty NumberStyles

Prvky jsou povoleny v s, kromě číslic

NumberStyles.None

Pouze desítkové číslice.

NumberStyles.AllowDecimalPoint

. a fractional_digits prvky. Však fractional_digits musí obsahovat pouze jednu nebo více číslic 0 nebo OverflowException je vyvolána výjimka.

NumberStyles.AllowExponent

s Může používat také exponenciální zápis.

NumberStyles.AllowLeadingWhite

Ws element na začátku s.

NumberStyles.AllowTrailingWhite

Ws element na konci s.

NumberStyles.AllowLeadingSign

Může zobrazit kladné znaménko před číslic.

NumberStyles.AllowTrailingSign

Může zobrazit kladné znaménko po číslic.

NumberStyles.AllowParentheses

I když tento příznak je podporováno, použijte závorky v s vede OverflowException.

NumberStyles.AllowThousands

I když symbol oddělovače skupiny se mohou objevit v s, může být uvozen pouze jednu nebo více číslic 0.

NumberStyles.AllowCurrencySymbol

$ Element.

Pokud NumberStyles.AllowHexSpecifier příznak se používá, s musí být šestnáctkové hodnoty bez předpony. Například "F3" analyzuje úspěšně, ale nikoli "0xF3". Jediné jiné příznaky, které mohou být přítomny v style jsou NumberStyles.AllowLeadingWhite a NumberStyles.AllowTrailingWhite. ( NumberStyles Výčet má složený styl čísla, NumberStyles.HexNumber, obsahující oba příznaky prázdných znaků.)

provider Parametr je IFormatProvider implementace, jako je například NumberFormatInfo nebo CultureInfo objektu. provider Poskytuje informace specifické jazykové verze používají při analýze. Pokud provider je null, používá aktuální jazykové verzi vlákna.

Následující příklad kódu analyzuje řetězcové reprezentace Byte hodnoty se tato přetížení Byte.Parse(String, NumberStyles, IFormatProvider) Metoda.

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.

Univerzální platforma Windows
K dispozici od 8
.NET Framework
K dispozici od 1.1
Přenosná knihovna tříd
Podporováno v: přenosné platformy .NET
Silverlight
K dispozici od 2.0
Windows Phone Silverlight
K dispozici od 7.0
Windows Phone
K dispozici od 8.1
Zpět na začátek
Zobrazit: