NumberStyles NumberStyles NumberStyles NumberStyles Enum

Definizione

Determina gli stili consentiti negli argomenti di stringa numerici passati ai metodi Parse e TryParse dei tipi numerici integrali e a virgola mobile.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.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

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

Campi

AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol AllowCurrencySymbol 256

Indica che la stringa numerica può contenere un simbolo di valuta.Indicates that the numeric string can contain a currency symbol. I simboli di valuta validi sono determinati dalla proprietà CurrencySymbol.Valid currency symbols are determined by the CurrencySymbol property.

AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint AllowDecimalPoint 32

Indica che nella stringa numerica può essere presente un separatore decimale.Indicates that the numeric string can have a decimal point. Se il valore NumberStyles include il flag AllowCurrencySymbol e la stringa analizzata include un simbolo di valuta, il carattere del separatore decimale è determinato dalla proprietà 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. In caso contrario, il carattere separatore dei decimali è determinato dalla proprietà NumberDecimalSeparator.Otherwise, the decimal separator character is determined by the NumberDecimalSeparator property.

AllowExponent AllowExponent AllowExponent AllowExponent 128

Indica che nella stringa numerica può essere presente un simbolo di esponente.Indicates that the numeric string can be in exponential notation. Il flag AllowExponent consente alla stringa analizzata di contenere un esponente che inizia con il carattere "E" o "e", seguito da un segno positivo o un segno negativo facoltativo e un Integer.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. In altre parole il flag analizza correttamente stringhe nel formato nnnExx, nnnE+xx e nnnE-xx.In other words, it successfully parses strings in the form nnnExx, nnnE+xx, and nnnE-xx. Non sono consentiti separatori o segni decimali nel significando o nella mantissa; per consentire l'analisi di tali elementi nella stringa, utilizzare i flag AllowDecimalPoint e AllowLeadingSign, oppure uno stile composito che includa tali flag specifici.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

Indica che la stringa numerica rappresenta un valore esadecimale.Indicates that the numeric string represents a hexadecimal value. I valori esadecimali validi includono le cifre numeriche 0-9 e le cifre esadecimali A-F e a-f.Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. Le stringhe analizzate con questo stile non possono essere precedute da "0x" o da "&h".Strings that are parsed using this style cannot be prefixed with "0x" or "&h". Una stringa analizzata con lo stile AllowHexSpecifier verrà sempre interpretata come valore esadecimale.A string that is parsed with the AllowHexSpecifier style will always be interpreted as a hexadecimal value. Gli unici altri flag che possono essere combinati con AllowHexSpecifier sono AllowLeadingWhite e AllowTrailingWhite.The only flags that can be combined with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. L'enumerazione NumberStyles include uno stile composto, HexNumber, costituito da tutti e tre i flag.The NumberStyles enumeration includes a composite style, HexNumber, that consists of these three flags.

AllowLeadingSign AllowLeadingSign AllowLeadingSign AllowLeadingSign 4

Indica che nella stringa numerica può essere presente un segno iniziale.Indicates that the numeric string can have a leading sign. I caratteri validi per i segni iniziali sono determinati dalle proprietà PositiveSign e NegativeSign.Valid leading sign characters are determined by the PositiveSign and NegativeSign properties.

AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite 1

Indica che nella stringa analizzata può essere presente un carattere di spazio iniziale.Indicates that leading white-space characters can be present in the parsed string. I caratteri di spazio validi sono associati ai codici Unicode U+0009, U+000A, U+000B, U+000C, U+000D e U+0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Notare che si tratta di un sottoinsieme dei caratteri per i quali il metodo IsWhiteSpace(Char) restituisce true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

AllowParentheses AllowParentheses AllowParentheses AllowParentheses 16

Indica che nella stringa numerica può essere presente una coppia di parentesi che racchiude un numero.Indicates that the numeric string can have one pair of parentheses enclosing the number. Le parentesi indicano che la stringa da analizzare rappresenta un numero negativo.The parentheses indicate that the string to be parsed represents a negative number.

AllowThousands AllowThousands AllowThousands AllowThousands 64

Indica che nella stringa numerica possono essere presenti separatori di gruppo, ad esempio simboli di separazione tra le centinaia e le migliaia.Indicates that the numeric string can have group separators, such as symbols that separate hundreds from thousands. Se il valore NumberStyles include il flag AllowCurrencySymbol e la stringa da analizzare include un simbolo di valuta, il carattere separatore di gruppi valido viene determinato dalla proprietà CurrencyGroupSeparator e il numero di cifre in ogni gruppo viene determinato dalla proprietà 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. In caso contrario, il carattere separatore dei decimali valido è determinato dalla proprietà NumberGroupSeparator e il numero di cifre in ciascun gruppo dalla proprietà 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 AllowTrailingSign AllowTrailingSign AllowTrailingSign 8

Indica che nella stringa numerica può essere presente un segno finale.Indicates that the numeric string can have a trailing sign. I caratteri validi per i segni finali sono determinati dalle proprietà PositiveSign e NegativeSign.Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties.

AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite 2

Indica che nella stringa analizzata possono essere presenti caratteri di spazio finale.Indicates that trailing white-space characters can be present in the parsed string. I caratteri di spazio validi sono associati ai codici Unicode U+0009, U+000A, U+000B, U+000C, U+000D e U+0020.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. Notare che si tratta di un sottoinsieme dei caratteri per i quali il metodo IsWhiteSpace(Char) restituisce true.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

Any Any Any Any 511

Indica che vengono utilizzati tutti gli stili, ad eccezione di AllowHexSpecifier.Indicates that all styles except AllowHexSpecifier are used. Si tratta di uno stile di numero composto.This is a composite number style.

Currency Currency Currency Currency 383

Indica che vengono utilizzati tutti gli stili, ad eccezione di AllowExponent e AllowHexSpecifier.Indicates that all styles except AllowExponent and AllowHexSpecifier are used. Si tratta di uno stile di numero composto.This is a composite number style.

Float Float Float Float 167

Indica che vengono utilizzati gli stili AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint e AllowExponent.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. Si tratta di uno stile di numero composto.This is a composite number style.

HexNumber HexNumber HexNumber HexNumber 515

Indica che vengono utilizzati gli stili AllowLeadingWhite, AllowTrailingWhite e AllowHexSpecifier.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. Si tratta di uno stile di numero composto.This is a composite number style.

Integer Integer Integer Integer 7

Indica che vengono utilizzati gli stili AllowLeadingWhite, AllowTrailingWhite e AllowLeadingSign.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. Si tratta di uno stile di numero composto.This is a composite number style.

None None None None 0

Indica che nella stringa analizzata non può essere presente alcun elemento di stile, ad esempio spazio iniziale o finale, separatori delle migliaia o separatore decimale.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 stringa da analizzare deve essere composta unicamente da cifre decimali integrali.The string to be parsed must consist of integral decimal digits only.

Number Number Number Number 111

Indica che vengono utilizzati gli stili AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint e AllowThousands.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. Si tratta di uno stile di numero composto.This is a composite number style.

Esempi

In questo esempio viene illustrato come analizzare una stringa in un integer a 32 bit utilizzando vari 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'.

Commenti

Il NumberStyles enumerazione è costituito da due tipi di valori di enumerazione che consentono di analizzare le rappresentazioni di stringa dei valori numerici:The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • Flag dei singoli campi, che definiscono gli elementi di stile specifico (ad esempio spazi vuoti e separatori di gruppi) che possono essere presenti nella stringa analizzata.Individual field flags, which define specific style elements (such as white space and group separators) that can be present in the parsed string.

  • Stili numerici composti, costituiti da più flag dei campi che definiscono gli elementi di stile che possono essere presenti nella stringa analizzata.Composite number styles, which consist of multiple field flags that define the style elements that can be present in the parsed string.

Ad eccezione di AllowHexSpecifier il singolo campo flag nel AllowHexSpecifier enumerazione definire elementi di stile che vengono usati quando l'analisi la rappresentazione di stringa di un numero decimale.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 indica che solo le cifre possono essere presenti nella stringa analizzata.None indicates that only digits can be present in the parsed string. I flag dei singoli campi rimanenti definiscono elementi di stile che possono essere, ma non sono necessario essere, presenti nella rappresentazione di stringa di un numero decimale per l'operazione di analisi abbia esito positivo.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. Al contrario, il flag AllowHexSpecifier indica che la stringa da analizzare viene sempre interpretata come valore esadecimale.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. I flag dei campi solo di singoli che possono essere usati con AllowHexSpecifier sono AllowLeadingWhite e AllowTrailingWhite.The only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. Il NumberStyles enumerazione include uno stile di numero composto, HexNumber, costituito da tutti i tre flag.The NumberStyles enumeration includes a composite number style, HexNumber, that consists of all three flags.

I simboli (ad esempio il simbolo di valuta, il separatore di gruppi, il separatore decimale e i segni positivi e negativi) che possono essere visualizzati nella stringa da analizzare sono definiti dai membri del System.Globalization.NumberFormatInfo oggetto passato in modo implicito o esplicito per il Parse (metodo).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. Tabella dei membri in questo argomento viene fornita una descrizione di ogni singolo flag e indica la relazione con NumberFormatInfo proprietà.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

Nella tabella seguente vengono elencati gli stili di numero composto e indica i flag del singolo campo includono.The following table lists the composite number styles and indicates which individual field flags they include. "1" in una cella indica che lo stile di numero composto include lo stile del numero singolo in tale riga.A "1" in a cell indicates that the composite number style includes the individual number style in that row. "0" indica che lo stile di numero composto non include lo stile del numero singoli.A "0" indicates that the composite number style does not include the individual number style.

QualsiasiAny ValutaCurrency FloatFloat IntegerInteger NumberNumber 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)

Si applica a

Vedi anche