NumberStyles Výčet

Definice

Obor názvů:

System.Globalization

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

NumberStyles.cs

Určuje styly povolené v argumentech číselného řetězce, které jsou předány Parse a TryParse metody integrálních a číselných typů s plovoucí desetinnou čárkou.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class NumberStyles

[System.Flags]
public enum NumberStyles

[<System.Flags>]
type NumberStyles = 

Public Enum NumberStyles

Dědičnost

Object

ValueType

Enum

NumberStyles

Atributy

FlagsAttribute

Pole

Name	Hodnota	Description
None	0	Označuje, že v analyzovaném řetězci se nedají vyskytovat žádné prvky stylu, například počáteční nebo koncové prázdné znaky, oddělovače tisíců nebo oddělovač desetinných míst. Řetězec, který se má analyzovat, musí obsahovat pouze celočíselné desetinné číslice.
AllowLeadingWhite	1	Označuje, že počáteční prázdné znaky mohou být přítomné v analyzovaném řetězci. Platné prázdné znaky mají hodnoty Unicode U+0009, U+000A, U+000B, U+000C, U+000D a U+0020. Všimněte si, že se jedná o podmnožinu znaků, pro které IsWhiteSpace(Char) metoda vrací true.
AllowTrailingWhite	2	Označuje, že v analyzovaném řetězci mohou být přítomny koncové prázdné znaky. Platné prázdné znaky mají hodnoty Unicode U+0009, U+000A, U+000B, U+000C, U+000D a U+0020. Všimněte si, že se jedná o podmnožinu znaků, pro které IsWhiteSpace(Char) metoda vrací true.
AllowLeadingSign	4	Označuje, že číselný řetězec může mít počáteční znaménko. Platné počáteční znaky jsou určeny vlastnostmi a PositiveSign vlastnostmiNegativeSign.
Integer	7	Označuje, že AllowLeadingWhitejsou použity , AllowTrailingWhitea AllowLeadingSign styly. Jedná se o složený styl čísla.
AllowTrailingSign	8	Označuje, že číselný řetězec může mít koncové znaménko. Platné koncové znaky jsou určeny vlastnostmi a PositiveSign vlastnostmiNegativeSign.
AllowParentheses	16	Označuje, že číselný řetězec může mít jednu dvojici závorek ohraničující číslo. Závorky označují, že řetězec, který se má analyzovat, představuje záporné číslo.
AllowDecimalPoint	32	Označuje, že číselný řetězec může mít desetinnou čárku. NumberStyles Pokud hodnota obsahuje AllowCurrencySymbol příznak a analyzovaný řetězec obsahuje symbol měny, znak oddělovače desetinných míst je určen CurrencyDecimalSeparator vlastností. V opačném případě je znak oddělovače desetinných míst určen NumberDecimalSeparator vlastností.
AllowThousands	64	Označuje, že číselný řetězec může mít oddělovače skupin, například symboly, které oddělují stovky od tisíců. NumberStyles Pokud hodnota obsahuje AllowCurrencySymbol příznak a řetězec, který se má analyzovat, obsahuje symbol měny, platný znak oddělovače skupin je určen CurrencyGroupSeparator vlastností a počet číslic v každé skupině je určen CurrencyGroupSizes vlastností. V opačném případě je platný znak oddělovače skupin určen NumberGroupSeparator vlastností a počet číslic v každé skupině je určen NumberGroupSizes vlastností.
Number	111	Označuje, že AllowLeadingWhitese používají styly , , AllowTrailingWhite, AllowLeadingSignAllowTrailingSignAllowDecimalPointa AllowThousands styly. Jedná se o složený styl čísla.
AllowExponent	128	Označuje, že číselný řetězec může být v exponenciálním zápisu. Příznak AllowExponent umožňuje parsovaný řetězec obsahovat exponent, který začíná znakem "E" nebo "e", a za ním volitelné kladné nebo záporné znaménko a celé číslo. Jinými slovy, úspěšně parsuje řetězce ve tvaru nnnExx, nnnE+xx a nnnE-xx. Nepovoluje oddělovač desetinných míst nebo znak significand nebo mantis; pokud chcete těmto prvkům v řetězci povolit analýzu, použijte AllowDecimalPoint příznaky a AllowLeadingSign příznaky nebo použijte složený styl, který obsahuje tyto jednotlivé příznaky.
Float	167	Označuje, že AllowLeadingWhitese používají styly , , AllowTrailingWhiteAllowLeadingSignAllowDecimalPoint, a AllowExponent styly. Jedná se o složený styl čísla.
AllowCurrencySymbol	256	Označuje, že číselný řetězec může obsahovat symbol měny. Platné symboly měny jsou určeny CurrencySymbol vlastností.
Currency	383	Označuje, že se používají všechny styly s výjimkou AllowExponent a AllowHexSpecifier jsou použity. Jedná se o složený styl čísla.
Any	511	Označuje, že se používají všechny styly s výjimkou AllowHexSpecifier a AllowBinarySpecifier jsou použity. Jedná se o složený styl čísla.
AllowHexSpecifier	512	Označuje, že číselný řetězec představuje šestnáctkovou hodnotu. Platné šestnáctkové hodnoty zahrnují číselné číslice 0–9 a šestnáctkové číslice A-F a a-f. Řetězce, které jsou analyzovány pomocí tohoto stylu, nemohou být předpony "0x" nebo "&h". Řetězec, který je analyzován stylem AllowHexSpecifier , bude vždy interpretován jako šestnáctková hodnota. Jediné příznaky, které lze kombinovat s AllowHexSpecifier jsou AllowLeadingWhite a AllowTrailingWhite. Výčet NumberStyles obsahuje složený styl, HexNumberkterý se skládá z těchto tří příznaků.
HexNumber	515	Označuje, že AllowLeadingWhitejsou použity , AllowTrailingWhitea AllowHexSpecifier styly. Jedná se o složený styl čísla.
AllowBinarySpecifier	1024	Označuje, že číselný řetězec představuje binární hodnotu. Platné binární hodnoty zahrnují číselné číslice 0 a 1. Řetězce, které jsou analyzovány pomocí tohoto stylu, nepoužívají předponu; 0b nelze použít. Řetězec, který je analyzován stylem AllowBinarySpecifier , bude vždy interpretován jako binární hodnota. Jediné příznaky, které lze kombinovat s AllowBinarySpecifier jsou AllowLeadingWhite a AllowTrailingWhite. Výčet NumberStyles obsahuje složený styl, BinaryNumberkterý se skládá z těchto tří příznaků.
BinaryNumber	1027	Označuje, že AllowLeadingWhitejsou použity , AllowTrailingWhitea AllowBinarySpecifier styly. Jedná se o složený styl čísla.

Příklady

Tento příklad ukazuje, jak analyzovat řetězec do 32bitového celého čísla pomocí různých NumberStyles příznaků.

using System;
using System.Text;
using System.Globalization;

public sealed class App
{
    static void Main()
    {
        // Parse the string as a hex value and display the value as a decimal.
        String num = "A";
        int val = int.Parse(num, NumberStyles.HexNumber);
        Console.WriteLine("{0} in hex = {1} in decimal.", num, val);

        // Parse the string, allowing a leading sign, and ignoring leading and trailing white spaces.
        num = "    -45   ";
        val = int.Parse(num, NumberStyles.AllowLeadingSign |
            NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite);
        Console.WriteLine("'{0}' parsed to an int is '{1}'.", num, val);

        // Parse the string, allowing parentheses, and ignoring leading and trailing white spaces.
        num = "    (37)   ";
        val = int.Parse(num, NumberStyles.AllowParentheses | NumberStyles.AllowLeadingSign |                         NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite);
        Console.WriteLine("'{0}' parsed to an int is '{1}'.", num, val);
    }
}

// This code produces the following output.
//
// A in hex = 10 in decimal.
// '    -45   ' parsed to an int is '-45'.
// '    (37)   ' parsed to an int is '-37'.

Imports System.Globalization
Imports System.Text

Public Module Example
   Public Sub Main() 
      ' Parse the string as a hex value and display the value as a decimal.
      Dim num As String = "A"
      Dim val As Integer = Int32.Parse(num, NumberStyles.HexNumber)
      Console.WriteLine("{0} in hex = {1} in decimal.", num, val)

      ' Parse the string, allowing a leading sign, and ignoring leading and trailing white spaces.
      num = "    -45   "
      val = Integer.Parse(num, NumberStyles.AllowLeadingSign Or 
                               NumberStyles.AllowLeadingWhite Or 
                               NumberStyles.AllowTrailingWhite)
      Console.WriteLine("'{0}' parsed to an integer is '{1}'.", num, val)

      ' Parse the string, allowing parentheses, and ignoring leading and trailing white spaces.
      num = "    (37)   "
      val = Integer.Parse(num, NumberStyles.AllowParentheses Or 
                               NumberStyles.AllowLeadingSign Or
                               NumberStyles.AllowLeadingWhite Or 
                               NumberStyles.AllowTrailingWhite)
      Console.WriteLine("'{0}' parsed to an integer is '{1}'.", num, val)
   End Sub
End Module
' The example displays the following output:
'       A in hex = 10 in decimal.
'       '    -45   ' parsed to an int is '-45'.
'       '    (37)   ' parsed to an int is '-37'.

Poznámky

Výčet NumberStyles se skládá ze dvou druhů hodnot výčtu, které se používají k analýze řetězcových reprezentací číselných hodnot:

• Jednotlivé příznaky polí, které definují specifické prvky stylu (například prázdné znaky a oddělovače skupin), které mohou být přítomné v analyzovaném řetězci.
• Složené styly čísel, které se skládají z více příznaků polí, které definují prvky stylu, které mohou být přítomné v analyzovaném řetězci.

Kromě toho AllowHexSpecifier, jednotlivé příznaky pole v výčtu NumberStyles definují prvky stylu, které se používají při analýze řetězcové reprezentace desetinné číslo. None označuje, že v analyzovaném řetězci mohou být přítomny pouze číslice. Zbývající jednotlivé příznaky polí definují prvky stylu, které mohou být, ale nemusí být, přítomné v řetězcové reprezentaci desetinné číslo, aby operace analýzy byla úspěšná. Naproti tomu příznak označuje, že řetězec, který se má analyzovat, AllowHexSpecifier je vždy interpretován jako šestnáctková hodnota. Jediné jednotlivé příznaky polí, se kterými lze použít AllowHexSpecifier , jsou AllowLeadingWhite a AllowTrailingWhite. Výčet NumberStyles obsahuje složený styl čísla, HexNumberkterý se skládá ze všech tří příznaků.

Symboly (například symbol měny, oddělovač skupin, oddělovač desetinných míst a kladné a záporné znaménka), které se mohou objevit v řetězci, které se mají analyzovat, jsou definovány členy objektu System.Globalization.NumberFormatInfo , který je předán implicitně nebo explicitně metodě Parse . Tabulka členů v tomto tématu obsahuje popis každého jednotlivého příznaku a označuje jeho relaci s NumberFormatInfo vlastnostmi.

Následující tabulka uvádí složené styly čísel a označuje, které jednotlivé pole označují příznaky, které obsahují. A "1" v buňce označuje, že složený styl čísla obsahuje v daném řádku styl jednotlivých čísel. Hodnota 0 označuje, že složený styl čísla neobsahuje individuální styl čísla.

	Any	Měna	Float	Integer	Number	Šestnáctkové číslo	BinaryNumber
AllowBinarySpecifier (0x0400)	0	0	0	0	0	0	1
AllowHexSpecifier (0x0200)	0	0	0	0	0	1	0
AllowCurrencySymbol (0x0100)	1	1	0	0	0	0	0
AllowExponent (0x0080)	1	0	1	0	0	0	0
AllowThousands (0x0040)	1	1	0	0	1	0	0
AllowDecimalPoint (0x0020)	1	1	1	0	1	0	0
AllowParentheses (0x0010)	1	1	0	0	0	0	0
AllowTrailingSign (0x0008)	1	1	0	0	1	0	0
AllowLeadingSign (0x0004)	1	1	1	1	1	0	0
AllowTrailingWhite (0x0002)	1	1	1	1	1	1	1
AllowLeadingWhite (0x0001)	1	1	1	1	1	1	1
	(0x1ff)	(0x17f)	(0x0a7)	(0x007)	(0x06f)	(0x203)	(0x403)

Viz také

• NumberFormatInfo