NumberStyles NumberStyles NumberStyles NumberStyles Enum

Definition

Bestimmt die Formate, die in numerischen Zeichenfolgenargumenten erlaubt sind, die an die Parse-Methode und TryParse-Methode des numerischen Typs der Ganzzahl oder einer Gleitkommazahl übergeben werden. 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.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

public enum class NumberStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[Serializable]
public enum NumberStyles
type NumberStyles = 
Public Enum NumberStyles
Inheritance
Attributes
FlagsAttribute ComVisibleAttribute SerializableAttribute

Fields

AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol 256

Gibt an, dass die numerische Zeichenfolge ein Währungssymbol enthalten kann. Indicates that the numeric string can contain a currency symbol. Gültige Währungssymbole werden von der CurrencySymbol-Eigenschaft bestimmt. Valid currency symbols are determined by the CurrencySymbol property.

AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint 32

Gibt an, dass die numerische Zeichenfolge ein Dezimaltrennzeichen enthalten kann. Indicates that the numeric string can have a decimal point. Wenn der NumberStyles-Wert das AllowCurrencySymbol-Flag enthält, und die analysierte Zeichenfolge ein Währungssymbol einschließt, wird das Dezimaltrennzeichen von der CurrencyDecimalSeparator-Eigenschaft bestimmt. 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. Andernfalls wird das Dezimaltrennzeichen von der NumberDecimalSeparator-Eigenschaft bestimmt. Otherwise, the decimal separator character is determined by the NumberDecimalSeparator property.

AllowExponent AllowExponent AllowExponent AllowExponent 128

Gibt an, dass die numerische Zeichenfolge in Exponentialschreibweise vorliegen kann. Indicates that the numeric string can be in exponential notation. Das AllowExponent-Flag ermöglicht es der analysierten Zeichenfolge, einen Exponenten zu enthalten, der mit dem Zeichen "E" oder "e" beginnt und dem ein optionales positives oder negatives Vorzeichen und eine ganze Zahl folgen. 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. Das heißt, dass es Zeichenfolgen in den Formen nnnExx, nnnE+xx und nnnE-xx erfolgreich analysiert. In other words, it successfully parses strings in the form nnnExx, nnnE+xx, and nnnE-xx. Es ist kein Dezimaltrennzeichen im Signifikanden oder in der Mantisse zulässig. Damit diese Elemente in der Zeichenfolge analysiert werden können, verwenden Sie das AllowDecimalPoint-Flag und das AllowLeadingSign-Flag, oder verwenden Sie ein zusammengesetztes Format, das diese einzelnen Flags enthält. 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

Gibt an, dass die numerische Zeichenfolge einen Hexadezimalwert darstellt. Indicates that the numeric string represents a hexadecimal value. Gültige Hexadezimalwerte können die numerischen Ziffern 0-9 und die Hexadezimalziffern A-F bzw. a-f enthalten. Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. Zeichenfolgen, die mit diesem Stil analysiert werden, kann „0x“ oder „&h“ vorangestellt sein. Strings that are parsed using this style cannot be prefixed with "0x" or "&h". Eine mit dem AllowHexSpecifier-Format analysierte Zeichenfolge wird immer als Hexadezimalwert interpretiert. A string that is parsed with the AllowHexSpecifier style will always be interpreted as a hexadecimal value. Die einzigen Flags, die mit AllowHexSpecifier kombiniert werden können, sind AllowLeadingWhite und AllowTrailingWhite. The only flags that can be combined with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. Die NumberStyles-Enumeration schließt ein zusammengesetztes Format ein, HexNumber, das aus diesen drei Flags besteht. The NumberStyles enumeration includes a composite style, HexNumber, that consists of these three flags.

AllowLeadingSign AllowLeadingSign AllowLeadingSign AllowLeadingSign 4

Gibt an, dass die numerische Zeichenfolge mit einem Vorzeichen versehen sein kann. Indicates that the numeric string can have a leading sign. Gültige Zeichen für Vorzeichen werden von der PositiveSign-Eigenschaft und der NegativeSign-Eigenschaft bestimmt. Valid leading sign characters are determined by the PositiveSign and NegativeSign properties.

AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite 1

Gibt an, dass führende Leerraumzeichen in der analysierten Zeichenfolge vorhanden sein dürfen. Indicates that leading white-space characters can be present in the parsed string. Gültige Leerzeichen haben die Unicode-Werte U+0009, U+000A, U+000B, U+000C, U+000D und U+0020. Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Hierbei handelt es sich um eine Teilmenge der Zeichen, für die die IsWhiteSpace(Char)-Methode true zurückgibt. Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

AllowParentheses AllowParentheses AllowParentheses AllowParentheses 16

Gibt an, dass die numerische Zeichenfolge über ein die Zahl umschließendes Klammerpaar verfügen kann. Indicates that the numeric string can have one pair of parentheses enclosing the number. Die Klammern geben an, dass die zu analysierende Zeichenfolge eine negative Zahl darstellt. The parentheses indicate that the string to be parsed represents a negative number.

AllowThousands AllowThousands AllowThousands AllowThousands 64

Gibt an, dass die numerische Zeichenfolge über Gruppentrennzeichen verfügen kann, z. B. Symbole zum Trennen der Hunderter von den Tausendern. Indicates that the numeric string can have group separators, such as symbols that separate hundreds from thousands. Wenn der NumberStyles-Wert das AllowCurrencySymbol-Flag und die zu analysierende Zeichenfolge ein Währungssymbol einschließt, wird das gültige Gruppentrennzeichen von der CurrencyGroupSeparator-Eigenschaft bestimmt, und die Anzahl der Ziffern in jeder Gruppe wird von der CurrencyGroupSizes-Eigenschaft bestimmt. 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. Andernfalls wird das gültige Gruppentrennzeichen von der NumberGroupSeparator-Eigenschaft bestimmt, und die Anzahl der Ziffern in den einzelnen Gruppen wird von der NumberGroupSizes-Eigenschaft bestimmt. 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

Gibt an, dass die numerische Zeichenfolge mit einem nachstehenden Zeichen versehen sein kann. Indicates that the numeric string can have a trailing sign. Gültige nachstehende Zeichen werden von der PositiveSign-Eigenschaft und der NegativeSign-Eigenschaft bestimmt. Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties.

AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite 2

Gibt an, dass nachgestellte Leerraumzeichen in der analysierten Zeichenfolge vorhanden sein dürfen. Indicates that trailing white-space characters can be present in the parsed string. Gültige Leerzeichen haben die Unicode-Werte U+0009, U+000A, U+000B, U+000C, U+000D und U+0020. Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Hierbei handelt es sich um eine Teilmenge der Zeichen, für die die IsWhiteSpace(Char)-Methode true zurückgibt. Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

Any Any Any Any 511

Gibt an, dass alle Stile außer AllowHexSpecifier verwendet werden. Indicates that all styles except AllowHexSpecifier are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

Currency Currency Currency Currency 383

Gibt an, dass alle Stile außer AllowExponent und AllowHexSpecifier verwendet werden. Indicates that all styles except AllowExponent and AllowHexSpecifier are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

Float Float Float Float 167

Gibt an, dass die Stile AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint und AllowExponent verwendet werden. Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

HexNumber HexNumber HexNumber HexNumber 515

Gibt an, dass die Stile AllowLeadingWhite, AllowTrailingWhite und AllowHexSpecifier verwendet werden. Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

Integer Integer Integer Integer 7

Gibt an, dass die Stile AllowLeadingWhite, AllowTrailingWhite und AllowLeadingSign verwendet werden. Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

None None None None 0

Gibt an, dass keine Stilelemente, z. B. vorangestellte oder nachgestellte Leerstellen, Tausendertrennzeichen oder ein Dezimaltrennzeichen, in der analysierten Zeichenfolge vorhanden sein können. 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. Die zu analysierende Zeichenfolge muss ausschließlich aus ganzzahligen Dezimalziffern bestehen. The string to be parsed must consist of integral decimal digits only.

Number Number Number Number 111

Gibt an, dass die Stile AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint und AllowThousands verwendet werden. Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. Dies ist ein zusammengesetzter Zahlenstil. This is a composite number style.

Examples

Dieses Beispiel zeigt, wie eine Zeichenfolge in eine ganze 32-Bit-Zahl analysiert werden, mithilfe verschiedener AllowHexSpecifier Flags.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'.

Remarks

Die NumberStyles Enumeration besteht aus zwei Arten von Enumerationswerten, die beim Analysieren der Zeichenfolgendarstellung numerischer Werte verwendet werden:The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • Einzelnes Feld-Flags, die bestimmte Stilelemente (z.B. Leerzeichen und Gruppentrennzeichen) zu definieren, die in der analysierten Zeichenfolge vorhanden sein können.Individual field flags, which define specific style elements (such as white space and group separators) that can be present in the parsed string.

  • Zusammengesetzte Zahlenformate, die aus mehreren Feldflags bestehen, die die Stilelemente definiert, die in der analysierten Zeichenfolge vorhanden sein können.Composite number styles, which consist of multiple field flags that define the style elements that can be present in the parsed string.

Mit Ausnahme von AllowHexSpecifier Felds einzelner kennzeichnet, der AllowHexSpecifier Enumeration definieren Style-Elemente, die beim Analysieren der Zeichenfolgendarstellung einer ganzen Zahl verwendet werden.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. Keine: Gibt an, dass nur die Ziffern in der analysierten Zeichenfolge vorhanden sein können.None indicates that only digits can be present in the parsed string. Die übrigen Flags für die einzelnen Felds definieren Sie Stilelemente, die möglicherweise, aber keine sein soll, stellen in der Zeichenfolgendarstellung einer ganzen Zahl, damit der Analysevorgang erfolgreich ist.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. Im Gegensatz dazu gibt die AllowHexSpecifier-Flag an, dass die Zeichenfolge, die analysiert werden immer als Hexadezimalwert interpretiert wird.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. Die einzelne Feldflags, die mit AllowHexSpecifier verwendet werden können, sind Stile AllowLeadingWhite und AllowTrailingWhite.The only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. Die NumberStyles Enumeration umfasst einen zusammengesetzter Zahlenstil Hexzahl, die aus allen drei Flags besteht.The NumberStyles enumeration includes a composite number style, HexNumber, that consists of all three flags.

Die Symbole (z. B. das Währungssymbol, das Gruppentrennzeichen, Dezimaltrennzeichen und die positiven und negativen Vorzeichen), die in der zu analysierende Zeichenfolge angezeigt werden können, werden von den Mitgliedern der definiert die System.Globalization.NumberFormatInfo -Objekt, das entweder implizit oder explizit übergeben wird um die Parse Methode.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. Member-Tabelle in diesem Thema enthält eine Beschreibung jedes einzelnen Flags und gibt die Beziehung zu NumberFormatInfo Eigenschaften.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

In der folgende Tabelle werden die Formate für die kombinierte Anzahl aufgelistet und gibt die einzelne Feld-Flags, die sie enthalten.The following table lists the composite number styles and indicates which individual field flags they include. "1" in einer Zelle gibt an, dass die zusammengesetzter Zahlenstil das einzelne Zahlenformat in dieser Zeile enthält.A "1" in a cell indicates that the composite number style includes the individual number style in that row. Eine "0" gibt an, dass die zusammengesetzter Zahlenstil nicht die Formatvorlage der einzelnen Zahl enthält.A "0" indicates that the composite number style does not include the individual number style.

BeliebigAny WährungCurrency FloatFloat Ganze ZahlInteger AnzahlNumber HexzahlHexNumber
AllowHexSpecifier (0 x 0200)AllowHexSpecifier (0x0200) 00 00 00 00 00 11
AllowCurrencySymbol (0 x 0100)AllowCurrencySymbol (0x0100) 11 11 00 00 00 00
AllowExponent (0 x 0080)AllowExponent (0x0080) 11 00 11 00 00 00
AllowThousands (0 x 0040)AllowThousands (0x0040) 11 11 00 00 11 00
AllowDecimalPoint (0 x 0020)AllowDecimalPoint (0x0020) 11 11 11 00 11 00
AllowParentheses (0 x 0010)AllowParentheses (0x0010) 11 11 00 00 00 00
AllowTrailingSign (0 x 0008)AllowTrailingSign (0x0008) 11 11 00 00 11 00
AllowLeadingSign (0 x 0004)AllowLeadingSign (0x0004) 11 11 11 11 11 00
AllowTrailingWhite (0 x 0002)AllowTrailingWhite (0x0002) 11 11 11 11 11 11
Stile AllowLeadingWhite (0 x 0001)AllowLeadingWhite (0x0001) 11 11 11 11 11 11
(0x1ff)(0x1ff) (0x17f)(0x17f) (0x0a7)(0x0a7) (0x007)(0x007) (0x06f)(0x06f) (0x203)(0x203)

Applies to

See Also