Export (0) Print
Expand All

NumberStyles Enumeration

Determines the styles permitted in numeric string arguments that are passed to the Parse methods of the numeric base type classes.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

[Visual Basic]
<Flags>
<Serializable>
Public Enum NumberStyles
[C#]
[Flags]
[Serializable]
public enum NumberStyles
[C++]
[Flags]
[Serializable]
__value public enum NumberStyles
[JScript]
public
   Flags
 Serializable
enum NumberStyles

Remarks

The symbols to use for currency symbol, thousands separator, decimal point indicator, and leading sign are specified by NumberFormatInfo.

The AllowCurrencySymbol and AllowDecimalPoint values determine whether a Parse method treats an instance of a numeric type as a currency or as a number and, therefore, whether to use the currency properties or the number properties of the associated NumberFormatInfo. For example, if AllowCurrencySymbol is specified, a Parse method uses currency properties, such as CurrencyDecimalSeparator and CurrencyGroupSeparator. However, if AllowDecimalPoint is specified, the method uses number properties, such as NumberDecimalSeparator and NumberGroupSeparator.

The attributes of NumberStyles are set by using the bitwise inclusive OR of the field flags. The Most Significant Bit (MSB) is the leftmost bit.

In the following table, the rows are the number styles with individual field flags and the columns are the composite number styles that combine individual field flags.

Under the composite number styles, a "1" means that the composite number style includes the individual number style in that row; a "0" means the composite number style does not include the individual number style in that row.

The hexadecimal representation of the composite number styles are listed in the last row of the table.

  Any Currency Float Integer Number HexNumber
AllowCurrencySymbol (0x0100) 1 1 0 0 0 0
AllowExponent (0x0080) 1 0 1 0 0 0
AllowThousands (0x0040) 1 1 0 0 1 0
AllowDecimalPoint (0x0020) 1 1 1 0 1 0
AllowParentheses (0x0010) 1 1 0 0 0 0
AllowTrailingSign (0x0008) 1 1 0 0 1 0
AllowLeadingSign (0x0004) 1 1 1 1 1 0
AllowTrailingWhite (0x0002) 1 1 1 1 1 1
AllowLeadingWhite (0x0001) 1 1 1 1 1 1
AllowHexSpecifier (0x0200) 0 0 0 0 0 1

The AllowExponent style is used for numeric strings in one of the following forms:

[-] m. dddddd E+ xx

[-] m. dddddd E- xx

[-] m. dddddd e+ xx

[-] m. dddddd e- xx

One or more nonzero digits (m) precede the decimal separator ("."). A minus sign ("-") can precede m. The Type performing the conversion determines the number of decimal places (dddddd) in the string, and maximum and minimum values for xx and m. The exponent (+/ - xx) consists of either a plus or minus sign followed by at least one digit.

Members

Member name Description Value
AllowCurrencySymbol

Supported by the .NET Compact Framework.

Indicates that the numeric string is parsed as currency if it contains a currency symbol; otherwise, it is parsed as a number. Valid currency symbols are determined by the CurrencySymbol property of NumberFormatInfo. 256
AllowDecimalPoint

Supported by the .NET Compact Framework.

Indicates that the numeric string can have a decimal point. Valid decimal point characters are determined by the NumberDecimalSeparator and CurrencyDecimalSeparator properties of NumberFormatInfo. 32
AllowExponent

Supported by the .NET Compact Framework.

Indicates that the numeric string can be in exponential notation. 128
AllowHexSpecifier

Supported by the .NET Compact Framework.

Indicates that the numeric string represents a hexadecimal value. Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. Hexadecimal values can be left-padded with zeros. Strings parsed using this style are not permitted to be prefixed with "0x". 512
AllowLeadingSign

Supported by the .NET Compact Framework.

Indicates that the numeric string can have a leading sign. Valid leading sign characters are determined by the PositiveSign and NegativeSign properties of NumberFormatInfo. 4
AllowLeadingWhite

Supported by the .NET Compact Framework.

Indicates that a leading white-space character must be ignored during parsing. Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. 1
AllowParentheses

Supported by the .NET Compact Framework.

Indicates that the numeric string can have one pair of parentheses enclosing the number. 16
AllowThousands

Supported by the .NET Compact Framework.

Indicates that the numeric string can have group separators; for example, separating the hundreds from the thousands. Valid group separator characters are determined by the NumberGroupSeparator and CurrencyGroupSeparator properties of NumberFormatInfo and the number of digits in each group is determined by the NumberGroupSizes and CurrencyGroupSizes properties of NumberFormatInfo. 64
AllowTrailingSign

Supported by the .NET Compact Framework.

Indicates that the numeric string can have a trailing sign. Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties of NumberFormatInfo. 8
AllowTrailingWhite

Supported by the .NET Compact Framework.

Indicates that trailing white-space character must be ignored during parsing. Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. 2
Any

Supported by the .NET Compact Framework.

Indicates that all styles, except AllowHexSpecifier, are used. This is a composite number style. 511
Currency

Supported by the .NET Compact Framework.

Indicates that all styles, except AllowExponent and AllowHexSpecifier, are used. This is a composite number style. 383
Float

Supported by the .NET Compact Framework.

Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. This is a composite number style. 167
HexNumber

Supported by the .NET Compact Framework.

Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. This is a composite number style. 515
Integer

Supported by the .NET Compact Framework.

Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. This is a composite number style. 7
None

Supported by the .NET Compact Framework.

Indicates that none of the bit styles are allowed. 0
Number

Supported by the .NET Compact Framework.

Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. This is a composite number style. 111

Requirements

Namespace: System.Globalization

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

Assembly: Mscorlib (in Mscorlib.dll)

See Also

System.Globalization Namespace | NumberFormatInfo

Show:
© 2014 Microsoft