NumberStyles NumberStyles NumberStyles NumberStyles Enum

Definicja

Określa style dozwolony w ciągu numerycznego argumenty, które są przekazywane do Parse i TryParse metody całkowite i zmiennoprzecinkowe typy liczbowe.Determines the styles permitted in numeric string arguments that are passed to the Parse and TryParse methods of the integral and floating-point numeric types.

To wyliczenie ma atrybut FlagsAttribute zezwalający na bitową kombinację jego wartości składowych.

public enum class NumberStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum NumberStyles
type NumberStyles = 
Public Enum NumberStyles
Dziedziczenie
Atrybuty

Pola

AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol 256

Wskazuje, że w ciągu numerycznego może zawierać symbolu waluty.Indicates that the numeric string can contain a currency symbol. Symbole walut prawidłowe są określane przez CurrencySymbol właściwości.Valid currency symbols are determined by the CurrencySymbol property.

AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint 32

Wskazuje, że ciągów liczbowych mogą mieć separator dziesiętny.Indicates that the numeric string can have a decimal point. Jeśli NumberStyles wartość obejmuje AllowCurrencySymbol flagę i przeanalizowany ciąg zawiera symbol waluty, znak separatora dziesiętnego jest określana przez CurrencyDecimalSeparator właściwości.If the NumberStyles value includes the AllowCurrencySymbol flag and the parsed string includes a currency symbol, the decimal separator character is determined by the CurrencyDecimalSeparator property. W przeciwnym razie znak separatora dziesiętnego jest określana przez NumberDecimalSeparator właściwości.Otherwise, the decimal separator character is determined by the NumberDecimalSeparator property.

AllowExponent AllowExponent AllowExponent AllowExponent 128

Wskazuje, że ciągu numerycznego może być w zapisie wykładniczym.Indicates that the numeric string can be in exponential notation. AllowExponent Flaga umożliwia przeanalizowany ciąg zawiera wykładnik, który zaczyna się od znaku "E" lub "e" i którym następuje opcjonalny znak dodatnia lub ujemna i liczby całkowitej.The AllowExponent flag allows the parsed string to contain an exponent that begins with the "E" or "e" character and that is followed by an optional positive or negative sign and an integer. Innymi słowy, pomyślnie analizuje ciągów w formie nnnExx, nnnE +xx, i nnn E -xx.In other words, it successfully parses strings in the form nnnExx, nnnE+xx, and nnnE-xx. Nie zezwalaj na separator dziesiętny lub logowania się w mantysę lub mantysy; Aby zezwolić na te elementy w ciągu, który ma być analizowany, należy użyć AllowDecimalPoint i AllowLeadingSign flagi, lub użyj złożonego styl, który zawiera te poszczególne flagi.It does not allow a decimal separator or sign in the significand or mantissa; to allow these elements in the string to be parsed, use the AllowDecimalPoint and AllowLeadingSign flags, or use a composite style that includes these individual flags.

AllowHexSpecifier AllowHexSpecifier AllowHexSpecifier AllowHexSpecifier 512

Wskazuje, że ciągu numerycznego reprezentuje wartość szesnastkową.Indicates that the numeric string represents a hexadecimal value. Prawidłowe wartości szesnastkowe obejmują cyfry 0-9 i cyfr szesnastkowych, A-F i a-f.Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. Ciągi, które są analizowane przy użyciu tego stylu nie prefiksem "0 x" lub "&h".Strings that are parsed using this style cannot be prefixed with "0x" or "&h". Ciąg, który jest analizowany przy użyciu AllowHexSpecifier styl zawsze będzie interpretowany jako wartość szesnastkową.A string that is parsed with the AllowHexSpecifier style will always be interpreted as a hexadecimal value. Tylko flagi, które mogą być łączone z AllowHexSpecifierAllowLeadingWhite i AllowTrailingWhite.The only flags that can be combined with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. NumberStyles Wyliczenia zawiera styl kompozytowy HexNumber, który składa się z tych trzech flag.The NumberStyles enumeration includes a composite style, HexNumber, that consists of these three flags.

AllowLeadingSign AllowLeadingSign AllowLeadingSign AllowLeadingSign 4

Wskazuje, że ciągu numerycznego, może być znakiem wiodącym.Indicates that the numeric string can have a leading sign. Prawidłowe znaki znaku wiodącego są określane przez PositiveSign i NegativeSign właściwości.Valid leading sign characters are determined by the PositiveSign and NegativeSign properties.

AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite 1

Wskazuje, że wiodące znaki białych pól mogą być obecne w ciągu przeanalizowany.Indicates that leading white-space characters can be present in the parsed string. Prawidłowe znaki spacji mają wartości Unicode U + 0009, U + 000A, U + 000B, U + 000C, U + 000D i U + 0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Należy zauważyć, że to podzbiór znaków, dla których IsWhiteSpace(Char) metoda zwraca true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

AllowParentheses AllowParentheses AllowParentheses AllowParentheses 16

Wskazuje, że w ciągu numerycznego może mieć jedną parę nawiasów obejmujących numer.Indicates that the numeric string can have one pair of parentheses enclosing the number. Nawiasy wskazują, że ciąg można przeanalizować reprezentuje liczbą ujemną.The parentheses indicate that the string to be parsed represents a negative number.

AllowThousands AllowThousands AllowThousands AllowThousands 64

Wskazuje, że ciągów liczbowych mogą mieć separatory grup, takich jak symbole rozdzielających setki z tysięcy.Indicates that the numeric string can have group separators, such as symbols that separate hundreds from thousands. Jeśli NumberStyles wartość obejmuje AllowCurrencySymbol Flaga, a ciąg można przeanalizować zawiera symbol waluty, znak separatora grupy jest określana przez CurrencyGroupSeparator właściwości, a liczba cyfr w każdej grupy jest określana przez CurrencyGroupSizes właściwości.If the NumberStyles value includes the AllowCurrencySymbol flag and the string to be parsed includes a currency symbol, the valid group separator character is determined by the CurrencyGroupSeparator property, and the number of digits in each group is determined by the CurrencyGroupSizes property. W przeciwnym razie znak separatora grupy jest określana przez NumberGroupSeparator właściwości, a liczba cyfr w każdej grupy jest określana przez NumberGroupSizes właściwości.Otherwise, the valid group separator character is determined by the NumberGroupSeparator property, and the number of digits in each group is determined by the NumberGroupSizes property.

AllowTrailingSign AllowTrailingSign AllowTrailingSign AllowTrailingSign 8

Wskazuje, że ciągu numerycznego, może być symbolem.Indicates that the numeric string can have a trailing sign. Prawidłowe końcowe znaki są określane przez znak PositiveSign i NegativeSign właściwości.Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties.

AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite 2

Wskazuje, że końcowe białe znaki mogą być obecne w ciągu przeanalizowany.Indicates that trailing white-space characters can be present in the parsed string. Prawidłowe znaki spacji mają wartości Unicode U + 0009, U + 000A, U + 000B, U + 000C, U + 000D i U + 0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Należy zauważyć, że to podzbiór znaków, dla których IsWhiteSpace(Char) metoda zwraca true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

Any Any Any Any 511

Wskazuje, że wszystkie style, z wyjątkiem AllowHexSpecifier są używane.Indicates that all styles except AllowHexSpecifier are used. Jest to kompozytowy styl.This is a composite number style.

Currency Currency Currency Currency 383

Wskazuje, że wszystkie style, z wyjątkiem AllowExponent i AllowHexSpecifier są używane.Indicates that all styles except AllowExponent and AllowHexSpecifier are used. Jest to kompozytowy styl.This is a composite number style.

Float Float Float Float 167

Oznacza to, że AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, i AllowExponent style są używane.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. Jest to kompozytowy styl.This is a composite number style.

HexNumber HexNumber HexNumber HexNumber 515

Oznacza to, że AllowLeadingWhite, AllowTrailingWhite, i AllowHexSpecifier style są używane.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. Jest to kompozytowy styl.This is a composite number style.

Integer Integer Integer Integer 7

Oznacza to, że AllowLeadingWhite, AllowTrailingWhite, i AllowLeadingSign style są używane.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. Jest to kompozytowy styl.This is a composite number style.

None None None None 0

Wskazuje, czy nie elementy stylu, takie jak wiodące lub końcowe białe miejsca, tysięcy separatory i separator dziesiętny może występować w przeanalizowany ciąg.Indicates that no style elements, such as leading or trailing white space, thousands separators, or a decimal separator, can be present in the parsed string. Ciąg, który ma być analizowany, musi zawierać tylko całkowite cyfry dziesiętne.The string to be parsed must consist of integral decimal digits only.

Number Number Number Number 111

Oznacza to, że AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, i AllowThousands style są używane.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. Jest to kompozytowy styl.This is a composite number style.

Przykłady

W tym przykładzie przedstawiono sposób analizowania na 32-bitową liczbę całkowitą przy użyciu różnych AllowHexSpecifier flag.This example shows how to parse a string into a 32-bit integer by using various AllowHexSpecifier flags.

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'.

Uwagi

NumberStyles Wyliczenia zawiera dwa rodzaje wartości wyliczenia, które są używane do analizowania ciągów reprezentujących wartości numeryczne:The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • Flagi poszczególnych pól, które definiują elementy konkretnego stylu (takie jak biały znak i separatory grup), które mogą być obecne w ciągu przeanalizowany.Individual field flags, which define specific style elements (such as white space and group separators) that can be present in the parsed string.

  • Style kompozytowy, które składają się z wielu flag pola, które definiują elementy stylu, które mogą być obecne w ciągu przeanalizowany.Composite number styles, which consist of multiple field flags that define the style elements that can be present in the parsed string.

Z wyjątkiem AllowHexSpecifier, poszczególne pola flagi w AllowHexSpecifier wyliczenie Zdefiniuj elementy stylu, które są używane podczas analizowania ciąg reprezentujący liczbę dziesiętną.Except for AllowHexSpecifier, the individual field flags in the AllowHexSpecifier enumeration define style elements that are used when parsing the string representation of a decimal number. None wskazuje, że tylko cyfry mogą być obecne w ciągu przeanalizowany.None indicates that only digits can be present in the parsed string. Pozostałe flagi poszczególnym polom definiują elementy stylu, które może, ale nie jest konieczne, obecne w ciągu reprezentującym liczbę dziesiętną dla udanej operacji analizy się powiodła.The remaining individual field flags define style elements that may be, but do not have to be, present in the string representation of a decimal number for the parse operation to succeed. Z kolei flagi AllowHexSpecifier wskazuje, że ciąg, który ma być analizowany, zawsze jest interpretowany jako wartość szesnastkową.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. Flagi tylko poszczególne pola, które mogą być używane z AllowHexSpecifier są AllowLeadingWhite i AllowTrailingWhite.The only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. NumberStyles Wyliczenia zawiera kompozytowy styl HexNumber, który składa się z trzech flag.The NumberStyles enumeration includes a composite number style, HexNumber, that consists of all three flags.

Symbole (np. symbol waluty, separator grupy, separator dziesiętny i podpisuje pozytywne i negatywne), które mogą być wyświetlane w ciągu, który ma być analizowany, są definiowane przez członków System.Globalization.NumberFormatInfo obiektu, który jest przekazywany jawnie lub niejawnie Aby Parse metody.The symbols (such as the currency symbol, the group separator, the decimal separator, and the positive and negative signs) that can appear in the string to be parsed are defined by the members of the System.Globalization.NumberFormatInfo object that is passed either implicitly or explicitly to the Parse method. Tabela elementów członkowskich, w tym temacie zawiera opis każdego poszczególne flagi i wskazuje jej relacji z NumberFormatInfo właściwości.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

Poniższa lista zawiera style kompozytowy i wskazuje flag poszczególnych pól, które należą do.The following table lists the composite number styles and indicates which individual field flags they include. "1" w komórce wskazuje, że kompozytowy styl zawiera poszczególne Styl liczbowy, w tym wierszu.A "1" in a cell indicates that the composite number style includes the individual number style in that row. "0" wskazuje, czy kompozytowy styl nie zawiera poszczególne styl liczb.A "0" indicates that the composite number style does not include the individual number style.

DowolneAny WalutaCurrency floatFloat Liczba całkowitaInteger Wartość liczbowaNumber HexNumberHexNumber
AllowHexSpecifier (0x0200)AllowHexSpecifier (0x0200) 00 00 00 00 00 11
AllowCurrencySymbol (0x0100)AllowCurrencySymbol (0x0100) 11 11 00 00 00 00
AllowExponent (0x0080)AllowExponent (0x0080) 11 00 11 00 00 00
AllowThousands (0x0040)AllowThousands (0x0040) 11 11 00 00 11 00
AllowDecimalPoint (0x0020)AllowDecimalPoint (0x0020) 11 11 11 00 11 00
AllowParentheses (0x0010)AllowParentheses (0x0010) 11 11 00 00 00 00
AllowTrailingSign (0x0008)AllowTrailingSign (0x0008) 11 11 00 00 11 00
AllowLeadingSign (0x0004)AllowLeadingSign (0x0004) 11 11 11 11 11 00
AllowTrailingWhite (0x0002)AllowTrailingWhite (0x0002) 11 11 11 11 11 11
AllowLeadingWhite (0x0001)AllowLeadingWhite (0x0001) 11 11 11 11 11 11
(0x1ff)(0x1ff) (0x17f)(0x17f) (0x0a7)(0x0a7) (0x007)(0x007) (0x06f)(0x06f) (0x203)(0x203)

Dotyczy

Zobacz też