Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

NumberStyles-Enumeration

 

Veröffentlicht: Oktober 2016

Bestimmt die in numerischen Zeichenfolgenargumenten, die übergeben werden, zulässigen Formate der Parse und TryParse Methoden die ganzzahligen Typen und numerischen Gleitkommatypen.

Diese Enumeration verfügt über ein FlagsAttribute-Attribut, das eine bitweise Kombination der Memberwerte zulässt.

Namespace:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[FlagsAttribute]
[ComVisibleAttribute(true)]
public enum NumberStyles

MembernameBeschreibung
AllowCurrencySymbol

Gibt an, dass die numerische Zeichenfolge ein Währungssymbol enthalten kann. Gültige Währungssymbole werden bestimmt, indem die NumberFormatInfo.CurrencySymbol Eigenschaft.

AllowDecimalPoint

Gibt an, dass die numerische Zeichenfolge ein Dezimaltrennzeichen enthalten kann. Wenn die NumberStyles Wert enthält die AllowCurrencySymbol -Flag und der analysierten Zeichenfolge ein Währungssymbol einschließt, das Dezimaltrennzeichen richtet sich nach der NumberFormatInfo.CurrencyDecimalSeparator Eigenschaft. Andernfalls wird das Dezimaltrennzeichen durch bestimmt die NumberFormatInfo.NumberDecimalSeparator Eigenschaft.

AllowExponent

Gibt an, dass die numerische Zeichenfolge in Exponentialschreibweise sein kann. Die AllowExponent -Flag ermöglicht es die analysierte Zeichenfolge enthalten ein Exponent, mit dem Zeichen "E" oder "e" beginnt und ein optionalen positiven oder negativen Vorzeichen und eine ganze Zahl folgen. In anderen Worten, sie Zeichenfolgen in der Form erfolgreich analysiert NnnEXx, NnnE +Xx, und NnnE -Xx. Keine Dezimaltrennzeichen zulassen oder melden Sie sich bei der Signifikanden oder Mantisse; Damit diese Elemente in der Zeichenfolge, die analysiert werden können, verwenden die AllowDecimalPoint und AllowLeadingSign kennzeichnet, oder verwenden Sie ein kombiniertes Format, das diese einzelnen Flags enthält.

AllowHexSpecifier

Gibt an, dass die numerische Zeichenfolge einen Hexadezimalwert darstellt. Gültige Hexadezimalwerte sind die numerischen Ziffern 0-9 und die Hexadezimalziffern A-F und a-f. Zeichenfolgen, die mit diesem Format analysiert werden dürfen nicht mit "0 X" oder "& h" beginnen. Eine Zeichenfolge, die mit der Analyse der AllowHexSpecifier Stil wird immer als Hexadezimalwert interpretiert werden. Die einzigen anderen Flags, die mit kombiniert werden können AllowHexSpecifier sind AllowLeadingWhite und AllowTrailingWhite. Die NumberStyles -Enumeration weist ein zusammengesetztes Format, HexNumber, besteht aus diesen drei Flags.

AllowLeadingSign

Gibt an, dass die numerische Zeichenfolge ein Vorzeichen aufweisen kann. Gültige Zeichen für Vorzeichen hängen von der NumberFormatInfo.PositiveSign und NumberFormatInfo.NegativeSign Eigenschaften.

AllowLeadingWhite

Gibt an, dass die führenden Leerzeichen in der analysierten Zeichenfolge vorhanden sein kann. Gültige Leerzeichen haben die Unicode-Werte U + 0009, U + 000A, U + 000 b, U + 000C, U + 000D und U + 0020. Beachten Sie, dass dies eine Teilmenge der Zeichen für die die Char.IsWhiteSpace -Methode gibt true.

AllowParentheses

Gibt an, dass die numerische Zeichenfolge ein paar Klammern die Anzahl einschließen kann. Die Klammern zeigen an, dass die zu analysierende Zeichenfolge eine negative Zahl darstellt.

AllowThousands

Gibt an, dass die numerische Zeichenfolge Gruppentrennzeichen, z. B. Symbole kann, die Hunderte von Tausenden voneinander zu trennen. Wenn die NumberStyles Wert enthält die AllowCurrencySymbol -Flag und die Zeichenfolge, die analysiert werden ein Währungssymbol einschließt, das gültige Gruppentrennzeichen richtet sich nach der NumberFormatInfo.CurrencyGroupSeparator -Eigenschaft und die Anzahl von Ziffern in jeder Gruppe wird bestimmt, indem die NumberFormatInfo.CurrencyGroupSizes Eigenschaft. Andernfalls wird das gültige Gruppentrennzeichen durch bestimmt die NumberFormatInfo.NumberGroupSeparator -Eigenschaft und die Anzahl von Ziffern in jeder Gruppe wird bestimmt, indem die NumberFormatInfo.NumberGroupSizes Eigenschaft.

AllowTrailingSign

Gibt an, dass die numerische Zeichenfolge eine nachfolgenden anmelden kann. Gültige nachstehende Zeichen, indem bestimmt werden die NumberFormatInfo.PositiveSign und NumberFormatInfo.NegativeSign Eigenschaften.

AllowTrailingWhite

Gibt an, dass nachfolgende Leerzeichen in der analysierten Zeichenfolge vorhanden sein kann. Gültige Leerzeichen haben die Unicode-Werte U + 0009, U + 000A, U + 000 b, U + 000C, U + 000D und U + 0020. Beachten Sie, dass dies eine Teilmenge der Zeichen für die die Char.IsWhiteSpace -Methode gibt true.

Any

Gibt an, dass alle Stile außer AllowHexSpecifier verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

Currency

Gibt an, dass alle Stile außer AllowExponent und AllowHexSpecifier verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

Float

Gibt an, dass die AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, und AllowExponent Stile verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

HexNumber

Gibt an, dass die AllowLeadingWhite, AllowTrailingWhite, und AllowHexSpecifier Stile verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

Integer

Gibt an, dass die AllowLeadingWhite, AllowTrailingWhite, und AllowLeadingSign Stile verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

None

Gibt an, dass keine Stilelemente, z. B. führende oder nachfolgende Leerstellen, Tausendertrennzeichen Trennzeichen oder ein Dezimaltrennzeichen, in der analysierten Zeichenfolge vorhanden sein kann. Die zu analysierende Zeichenfolge darf nur ganzzahlige Dezimalziffern bestehen.

Number

Gibt an, dass die AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, und AllowThousands Stile verwendet werden. Dies ist ein zusammengesetztes Zahlenformat.

Die NumberStyles Enumeration besteht aus zwei Arten von Enumerationswerten, die verwendet werden, die zeichenfolgenentsprechungen von numerischen Werten zu analysieren:

  • Einzelne Feldflags, die bestimmte Stilelemente (z. B. Leerstellen und Gruppentrennzeichen) definieren, die in der analysierten Zeichenfolge vorhanden sein können.

  • Zusammengesetzte Zahlenformate, die aus mehreren Feldflags bestehen, die die Stilelemente definieren, die in der analysierten Zeichenfolge vorhanden sein können.

Mit Ausnahme von AllowHexSpecifier, das Feld flags in der NumberStyles definieren Style-Elemente, die beim Analysieren der Darstellung einer ganzen Zahl verwendet werden. None Gibt an, dass nur Ziffern in der analysierten Zeichenfolge vorhanden sein können. Die übrigen Flags für die einzelnen Felder definieren die Style-Elemente, die möglicherweise, aber nicht sein soll, stellen in der Zeichenfolgendarstellung einer ganzen Zahl, damit der Analysevorgang erfolgreich ausgeführt werden kann. Im Gegensatz dazu die AllowHexSpecifier Flag gibt an, dass die Zeichenfolge, die analysiert werden immer als Hexadezimalwert interpretiert wird. Nur einzelne Feldflags, die mit verwendet werden können AllowHexSpecifier sind AllowLeadingWhite und AllowTrailingWhite. Die NumberStyles -Enumeration weist ein zusammengesetztes Zahlenformat HexNumber, besteht aus allen drei Flags.

Die Symbole (z. B. das Währungssymbol, das Gruppentrennzeichen, das Dezimaltrennzeichen und die positiven und negativen Vorzeichen), die in der zu analysierenden Zeichenfolge erscheinen können von den Mitgliedern der definiert die System.Globalization.NumberFormatInfo -Objekt, das entweder implizit oder explizit zu übergeben, wird die Parse Methode. Member-Tabelle in diesem Thema enthält eine Beschreibung jedes einzelnen Flags und gibt die Beziehung zu NumberFormatInfo Eigenschaften.

In der folgenden Tabelle sind die kombinierte Anzahl Formatvorlagen und gibt an, welche einzelnen Feldflags sie einschließen. "1" in einer Zelle gibt an, dass der zusammengesetzte Stil der einzelne Zahlenformat in dieser Zeile enthält. Eine "0" gibt an, dass der zusammengesetzte Stil der einzelne Zahlenformat nicht enthalten ist.

Beliebig

Währung

Float

Ganze Zahl

Anzahl

Hexzahl

AllowHexSpecifier (0 x 0200)

0

0

0

0

0

1

AllowCurrencySymbol (0 x 0100)

1

1

0

0

0

0

AllowExponent (0 x 0080)

1

0

1

0

0

0

AllowThousands (0 x 0040)

1

1

0

0

1

0

AllowDecimalPoint (0 x 0020)

1

1

1

0

1

0

AllowParentheses (0 x 0010)

1

1

0

0

0

0

AllowTrailingSign (0 x 0008)

1

1

0

0

1

0

AllowLeadingSign (0 x 0004)

1

1

1

1

1

0

AllowTrailingWhite (0 x 0002)

1

1

1

1

1

1

Stile AllowLeadingWhite (0 x 0001)

1

1

1

1

1

1

(0x1ff)

(0x17f)

(0x0a7)

(0x007)

(0x06f)

(0x203)

In diesem Beispiel wird gezeigt, wie zum Analysieren einer Zeichenfolge in eine 32-Bit-Ganzzahl mithilfe verschiedener NumberStyles Flags.

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: