NumberStyles Énumération

Définition

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

Héritage

Object

ValueType

Enum

NumberStyles

Attributs

FlagsAttribute SerializableAttribute ComVisibleAttribute

Champs

Exemples

Cet exemple montre comment analyser une chaîne en entier 32 bits à l’aide de différents NumberStyles indicateurs.

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’énumération NumberStyles se compose de deux types de valeurs d’énumération utilisées pour analyser les représentations sous forme de chaîne de valeurs numériques :

• 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.
• Styles de nombre composite, 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.

À l’exception de AllowHexSpecifier, les indicateurs de champ individuels de l’énumération NumberStyles définissent des éléments de style utilisés lors de l’analyse de la représentation sous forme de chaîne d’un nombre décimal. None indique que seuls les chiffres peuvent être présents dans la chaîne analysée. Les indicateurs de champ individuels restants définissent des éléments de style qui peuvent être, mais qui 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 réussisse. En revanche, l’indicateur AllowHexSpecifier indique que la chaîne à analyser est toujours interprétée comme une valeur hexadécimale. Les seuls indicateurs de champ individuels qui peuvent être utilisés avec AllowHexSpecifier sont AllowLeadingWhite et AllowTrailingWhite. L’énumération NumberStyles comprend un style de nombre composite, HexNumberqui se compose des trois indicateurs.

Les symboles (tels que le symbole monétaire, le séparateur de groupe, le séparateur décimal et les signes positifs et négatifs) qui peuvent apparaître dans la chaîne à analyser sont définis par les membres de l’objet System.Globalization.NumberFormatInfo transmis implicitement ou explicitement à la Parse méthode. La table membres de cette rubrique fournit une description de chaque indicateur individuel et indique sa relation avec NumberFormatInfo les propriétés.

Le tableau suivant répertorie les styles de nombre composite et indique les indicateurs de champ individuels qu’ils incluent. Un « 1 » dans une cellule indique que le style de nombre composite inclut le style de nombre individuel dans cette ligne. Un « 0 » indique que le style de nombre composite n’inclut pas le style de nombre individuel.

Voir aussi

• NumberFormatInfo