NumberStyles Enumerazione

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à
NumberStyles
Attributi

Campi

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

Questo esempio illustra come analizzare una stringa in un Integer a 32 bit usando diversi NumberStyles flag.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'.

Commenti

L' NumberStyles enumerazione è costituita da due tipi di valori di enumerazione usati per analizzare le rappresentazioni di stringa di valori numerici:The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • Singoli flag di campo, che definiscono elementi di stile specifici, ad esempio spazi vuoti e separatori di gruppo, 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 di campo 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 AllowHexSpecifierdi, i singoli flag NumberStyles di campo nell'enumerazione definiscono gli elementi di stile usati durante l'analisi della rappresentazione di stringa di un numero decimale.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. Noneindica che nella stringa analizzata possono essere presenti solo cifre.None indicates that only digits can be present in the parsed string. I singoli flag di campo restanti definiscono gli elementi di stile che possono essere, ma non devono essere, presenti nella rappresentazione di stringa di un numero decimale affinché 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 AllowHexSpecifier flag indica che la stringa da analizzare viene sempre interpretata come un valore esadecimale.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. Gli unici flag dei singoli campi che possono essere utilizzati AllowHexSpecifier con AllowLeadingWhite sono AllowTrailingWhitee.The only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. L' NumberStyles enumerazione include uno stile numerico composto, HexNumber, costituito da tutti e tre i 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 System.Globalization.NumberFormatInfo dell'oggetto passati in modo implicito o esplicito. Parse al 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. La tabella members in questo argomento fornisce una descrizione di ogni singolo flag e ne indica la NumberFormatInfo relazione con le proprietà.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

Nella tabella seguente sono elencati gli stili numerici compositi e vengono indicati i singoli flag di campo che includono.The following table lists the composite number styles and indicates which individual field flags they include. Un "1" in una cella indica che lo stile del numero composto include lo stile del singolo numero nella 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 del numero composto non include lo stile dei singoli numeri.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