NumberStyles Énumération

Définition

Détermine les styles autorisés dans les arguments de chaîne numérique passés aux méthodes Parse et TryParse des types numériques intégraux et à virgule flottante.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.

Cette énumération a un attribut FlagsAttribute qui permet une combinaison au niveau du bit de ses valeurs membres.

public enum class NumberStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum NumberStyles
type NumberStyles = 
Public Enum NumberStyles
Héritage
NumberStyles
Attributs

Champs

AllowCurrencySymbol 256

Indique que la chaîne numérique peut contenir un symbole monétaire.Indicates that the numeric string can contain a currency symbol. Les symboles monétaires valides sont déterminés par la propriété CurrencySymbol.Valid currency symbols are determined by the CurrencySymbol property.

AllowDecimalPoint 32

Indique que la chaîne numérique peut avoir une virgule décimale.Indicates that the numeric string can have a decimal point. Si la valeur NumberStyles inclut l’indicateur AllowCurrencySymbol et que la chaîne analysée inclut un symbole monétaire, le caractère de séparation décimale est déterminé par la propriété CurrencyDecimalSeparator.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. Sinon, le caractère de séparateur décimal est déterminé par la propriété NumberDecimalSeparator.Otherwise, the decimal separator character is determined by the NumberDecimalSeparator property.

AllowExponent 128

Indique que la chaîne numérique peut être écrite en notation exponentielle.Indicates that the numeric string can be in exponential notation. L’indicateur AllowExponent permet à la chaîne analysée de contenir un exposant qui commence par le caractère « E » ou « e » et d’être suivie par un positif facultatif ou un signe négatif et un entier.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. En d’autres termes, il analyse correctement des chaînes au format nnnExx, nnnE+xx et nnnE-xx.In other words, it successfully parses strings in the form nnnExx, nnnE+xx, and nnnE-xx. Il n’autorise pas un séparateur décimal ou un signe dans la mantisse ; pour autoriser ces éléments dans la chaîne à analyser, utilisez les indicateurs AllowDecimalPoint et AllowLeadingSign, ou utilisez un style composite qui inclut ces indicateurs individuels.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 512

Indique que la chaîne numérique représente une valeur hexadécimale.Indicates that the numeric string represents a hexadecimal value. Les valeurs hexadécimales valides incluent les chiffres 0-9 et les chiffres hexadécimaux A-F et a-f.Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. Les chaînes analysées à l’aide de ce style ne peuvent pas avoir pour préfixe « 0x » ou « &h ».Strings that are parsed using this style cannot be prefixed with "0x" or "&h". Une chaîne qui est analysée avec le style AllowHexSpecifier sera toujours interprétée comme une valeur hexadécimale.A string that is parsed with the AllowHexSpecifier style will always be interpreted as a hexadecimal value. Les seuls indicateurs pouvant être combinés avec AllowHexSpecifier sont AllowLeadingWhite et AllowTrailingWhite.The only flags that can be combined with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. L’énumération NumberStyles inclut un style composite, HexNumber, qui est composé de ces trois indicateurs.The NumberStyles enumeration includes a composite style, HexNumber, that consists of these three flags.

AllowLeadingSign 4

Indique que la chaîne numérique peut avoir un signe de début.Indicates that the numeric string can have a leading sign. Les caractères de signe de début valides sont déterminés par les propriétés PositiveSign et NegativeSign.Valid leading sign characters are determined by the PositiveSign and NegativeSign properties.

AllowLeadingWhite 1

Indique que des espaces blancs de début peuvent être présents dans la chaîne analysée.Indicates that leading white-space characters can be present in the parsed string. Les espaces valides ont les valeurs Unicode U+0009, U+000A, U+000B, U+000C, U+000D et U+0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Notez qu’il s’agit d’un sous-ensemble des caractères pour lesquels la méthode IsWhiteSpace(Char) retourne true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

AllowParentheses 16

Indique que la chaîne numérique peut avoir une paire de parenthèses englobant le nombre.Indicates that the numeric string can have one pair of parentheses enclosing the number. Les parenthèses indiquent que la chaîne à analyser représente une nombre négatif.The parentheses indicate that the string to be parsed represents a negative number.

AllowThousands 64

Indique que la chaîne numérique peut avoir des séparateurs de groupes, tels que des symboles qui séparent les centaines des milliers.Indicates that the numeric string can have group separators, such as symbols that separate hundreds from thousands. Si la valeur NumberStyles inclut l’indicateur AllowCurrencySymbol et que la chaîne à analyser inclut un symbole monétaire, le caractère de séparation des groupes valide est déterminé par la propriété CurrencyGroupSeparator, et le nombre de chiffres dans chaque groupe est déterminé par la propriété CurrencyGroupSizes.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. Sinon, le caractères de séparation de groupes valides est déterminé par la propriété NumberGroupSeparator, et le nombre de chiffres dans chaque groupe est déterminé par la propriété NumberGroupSizes.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 8

Indique que la chaîne numérique peut avoir un signe de fin.Indicates that the numeric string can have a trailing sign. Les caractères de signe de fin valides sont déterminés par les propriétés PositiveSign et NegativeSign.Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties.

AllowTrailingWhite 2

Indique que des espaces blancs de fin peuvent être présents dans la chaîne analysée.Indicates that trailing white-space characters can be present in the parsed string. Les espaces valides ont les valeurs Unicode U+0009, U+000A, U+000B, U+000C, U+000D et U+0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Notez qu’il s’agit d’un sous-ensemble des caractères pour lesquels la méthode IsWhiteSpace(Char) retourne true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

Any 511

Indique que tous les styles, à l’exception de AllowHexSpecifier, sont utilisés.Indicates that all styles except AllowHexSpecifier are used. Il s’agit d’un style de nombre composite.This is a composite number style.

Currency 383

Indique que tous les styles, à l’exception de AllowExponent et AllowHexSpecifier, sont utilisés.Indicates that all styles except AllowExponent and AllowHexSpecifier are used. Il s’agit d’un style de nombre composite.This is a composite number style.

Float 167

Indique que les styles AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint et AllowExponent sont utilisés.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. Il s’agit d’un style de nombre composite.This is a composite number style.

HexNumber 515

Indique que les styles AllowLeadingWhite, AllowTrailingWhite et AllowHexSpecifier sont utilisés.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. Il s’agit d’un style de nombre composite.This is a composite number style.

Integer 7

Indique que les styles AllowLeadingWhite, AllowTrailingWhite et AllowLeadingSign sont utilisés.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. Il s’agit d’un style de nombre composite.This is a composite number style.

None 0

Indique qu’aucun élément de style, tel que l’espace blanc de début ou de fin, les séparateurs de milliers ou un séparateur décimal, ne peut être présent dans la chaîne analysée.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. La chaîne à analyser doit uniquement être constituée de chiffres intégraux décimaux.The string to be parsed must consist of integral decimal digits only.

Number 111

Indique que les styles AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint et AllowThousands sont utilisés.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. Il s’agit d’un style de nombre composite.This is a composite number style.

Exemples

Cet exemple montre comment analyser une chaîne en entier 32 bits à l’aide de différents NumberStyles indicateurs.This example shows how to parse a string into a 32-bit integer by using various NumberStyles 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'.

Remarques

L' NumberStyles énumération est constituée de deux types de valeurs d’énumération utilisées pour analyser les représentations sous forme de chaîne de valeurs numériques:The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • Indicateurs de champ individuels, qui définissent des éléments de style spécifiques (tels que des espaces blancs et des séparateurs de groupes) qui peuvent être présents dans la chaîne analysée.Individual field flags, which define specific style elements (such as white space and group separators) that can be present in the parsed string.

  • Styles de nombres composites, qui se composent de plusieurs indicateurs de champ qui définissent les éléments de style qui peuvent être présents dans la chaîne analysée.Composite number styles, which consist of multiple field flags that define the style elements that can be present in the parsed string.

À l' AllowHexSpecifierexception de, les indicateurs de champ NumberStyles individuels dans l’énumération définissent les éléments de style utilisés lors de l’analyse de la représentation sous forme de chaîne d’un nombre décimal.Except for AllowHexSpecifier, the individual field flags in the NumberStyles enumeration define style elements that are used when parsing the string representation of a decimal number. Noneindique que seuls les chiffres peuvent être présents dans la chaîne analysée.None indicates that only digits can be present in the parsed string. Les indicateurs de champ individuels restants définissent des éléments de style qui peuvent être, mais n’ont pas besoin d’être, présents dans la représentation sous forme de chaîne d’un nombre décimal pour que l’opération d’analyse aboutisse.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. En revanche, l' AllowHexSpecifier indicateur indique que la chaîne à analyser est toujours interprétée comme une valeur hexadécimale.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. Les seuls indicateurs de champ individuels qui peuvent être utilisés AllowHexSpecifier avec AllowLeadingWhite sont AllowTrailingWhiteet.The only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. L' NumberStyles énumération inclut un style de nombre HexNumbercomposite,, qui se compose des trois indicateurs.The NumberStyles enumeration includes a composite number style, HexNumber, that consists of all three flags.

Les symboles (tels que le symbole monétaire, le séparateur de groupes, le séparateur décimal et les signes positif et négatif) qui peuvent apparaître dans la chaîne à analyser sont définis par les membres de l' System.Globalization.NumberFormatInfo objet qui est passé implicitement ou explicitement à la Parse méthode.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. La table des membres de cette rubrique fournit une description de chaque indicateur et indique sa relation avec NumberFormatInfo les propriétés.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

Le tableau suivant répertorie les styles de nombres composites et indique les indicateurs de champ individuels qu’ils incluent.The following table lists the composite number styles and indicates which individual field flags they include. Un «1» dans une cellule indique que le style de nombre composite comprend le style de nombre individuel dans cette ligne.A "1" in a cell indicates that the composite number style includes the individual number style in that row. Un «0» indique que le style de nombre composite n’inclut pas le style de nombre individuel.A "0" indicates that the composite number style does not include the individual number style.

AnyAny DeviseCurrency FloatFloat EntierInteger nombreNumber 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)

S’applique à

Voir aussi