NumberStyles Výčet

Definice

Určuje styly povolené v argumentech číselného řetězce, které jsou předány Parse celočíselným a TryParse plovoucí desetinným typům.

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

public enum class NumberStyles
[System.Flags]
public enum NumberStyles
[System.Flags]
[System.Serializable]
public enum NumberStyles
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum NumberStyles
[<System.Flags>]
type NumberStyles = 
[<System.Flags>]
[<System.Serializable>]
type NumberStyles = 
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NumberStyles = 
Public Enum NumberStyles
Dědičnost
NumberStyles
Atributy

Pole

AllowCurrencySymbol 256

Označuje, že číselný řetězec může obsahovat symbol měny. Platné symboly měny jsou určeny CurrencySymbol vlastností.

AllowDecimalPoint 32

Označuje, že číselný řetězec může mít desetinnou čárku. NumberStyles Pokud hodnota obsahuje AllowCurrencySymbol příznak a parsovaný ř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í.

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 formuláři nnnExx, nnnE+xx a nnnE-xx. Nepovoluje oddělovač desetinných míst ani significand nebo mantissa; chcete-li povolit, aby se tyto prvky v řetězci parsovaly, používaly a AllowLeadingSign označovaly příznakem nebo používaly AllowDecimalPoint složený styl, který obsahuje tyto jednotlivé příznaky.

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, nelze předponu "0x" nebo "&h". Řetězec, který je parsován se 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 zahrnuje složený styl, HexNumberkterý se skládá z těchto tří příznaků.

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 NegativeSign vlastnostmiPositiveSign.

AllowLeadingWhite 1

Označuje, že úvodní znaky prázdných znaků mohou být přítomné v parsované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 vrátí true.

AllowParentheses 16

Označuje, že číselný řetězec může mít jednu dvojici závorek, které číslo uzavře. Závorky označují, že řetězec, který se má analyzovat, představuje záporné číslo.

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 skupiny 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 skupiny určen NumberGroupSeparator vlastností a počet číslic v každé skupině je určen NumberGroupSizes vlastností.

AllowTrailingSign 8

Označuje, že číselný řetězec může mít koncové znaménko. Platné koncové znaky jsou určeny vlastnostmi a NegativeSign vlastnostmiPositiveSign.

AllowTrailingWhite 2

Označuje, že koncové znaky prázdných znaků můžou být přítomné v parsované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 vrátí true.

Any 511

Označuje, že se používají všechny styly s výjimkou AllowHexSpecifier . Jedná se o složený styl čísla.

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.

Float 167

Označuje, že se AllowLeadingWhitepoužívají styly , , , AllowDecimalPointAllowTrailingWhiteAllowLeadingSigna AllowExponent styly. Jedná se o složený styl čísla.

HexNumber 515

Označuje, že se AllowLeadingWhitepoužívají styly a , které AllowTrailingWhiteAllowHexSpecifier jsou použity. Jedná se o složený styl čísla.

Integer 7

Označuje, že se AllowLeadingWhitepoužívají styly a , které AllowTrailingWhiteAllowLeadingSign jsou použity. Jedná se o složený styl čísla.

None 0

Označuje, že žádné prvky stylu, jako jsou úvodní nebo koncové prázdné znaky, oddělovače tisíců nebo oddělovač desetinných míst, mohou být přítomné v parsovaném řetězci. Řetězec, který se má analyzovat, musí obsahovat pouze celočíselné desetinné číslice.

Number 111

Označuje, že se AllowLeadingWhitepoužívají styly , , , AllowTrailingSignAllowDecimalPointAllowTrailingWhiteAllowLeadingSign, a AllowThousands 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 namespace System;
using namespace System::Text;
using namespace System::Globalization;


int main()
{
    // Parse the string as a hex value and display the
    // value as a decimal.
    String^ numberString = "A";
    int stringValue = Int32::Parse(numberString, NumberStyles::HexNumber);
    Console::WriteLine("{0} in hex = {1} in decimal.",
        numberString, stringValue);

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

    // Parse the string, allowing parentheses, and ignoring
    // leading and trailing white spaces.
    numberString = "    (37)   ";
    stringValue = Int32::Parse(numberString, NumberStyles::AllowParentheses |
        NumberStyles::AllowLeadingSign | NumberStyles::AllowLeadingWhite |
        NumberStyles::AllowTrailingWhite);

    Console::WriteLine("'{0}' parsed to an int is '{1}'.",
        numberString, stringValue);
}

// 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'.
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 parsované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 parsovaném řetězci.

AllowHexSpecifierKromě toho, jednotlivé příznaky pole v výčtu NumberStyles definují prvky stylu, které se používají při analýze řetězcové reprezentace desetinného čísla. None označuje, že v parsované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, v řetězcové reprezentaci desetinné číslo pro operaci parsování úspěšné. Naproti tomu příznak označuje, že řetězec, AllowHexSpecifier který se má analyzovat, 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 k NumberFormatInfo vlastnostem.

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

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

Platí pro

Viz také