NumberStyles 열거형

정의

정수 및 부동 소수점 숫자 형식의 ParseTryParse 메서드에 전달되는 숫자 문자열에서 사용할 수 있는 스타일을 결정합니다.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.

이 열거형에는 멤버 값의 비트 조합을 허용하는 FlagsAttribute 특성이 있습니다.

public enum class NumberStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum NumberStyles
type NumberStyles = 
Public Enum NumberStyles
상속
NumberStyles
특성

필드

AllowCurrencySymbol 256

숫자 문자열에 통화 기호가 포함될 수 있음을 나타냅니다.Indicates that the numeric string can contain a currency symbol. 유효한 통화 기호는 CurrencySymbol 속성으로 결정됩니다.Valid currency symbols are determined by the CurrencySymbol property.

AllowDecimalPoint 32

숫자 문자열에 소수점이 있을 수 있음을 나타냅니다.Indicates that the numeric string can have a decimal point. NumberStyles 값에 AllowCurrencySymbol 플래그가 포함되고 구문 분석된 문자열에 통화 기호가 포함된 경우 10진 구분 기호 문자는 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. 그렇지 않으면 소수 구분 문자가 NumberDecimalSeparator 속성으로 결정됩니다.Otherwise, the decimal separator character is determined by the NumberDecimalSeparator property.

AllowExponent 128

숫자 문자열에 지수 표시가 있을 수 있음을 나타냅니다.Indicates that the numeric string can be in exponential notation. AllowExponent 플래그를 사용하면 구문 분석된 문자열에 "E" 또는 "e" 문자로 시작하고 선택적 양 또는 음의 부호 및 정수가 있는 지수를 포함할 수 있습니다.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. 즉, nnnExx, nnnE+xxnnnE-xx 형식으로 문자열을 성공적으로 구문 분석합니다.In other words, it successfully parses strings in the form nnnExx, nnnE+xx, and nnnE-xx. 소수 구분 기호나 유효 숫자 또는 가수의 부호를 허용하지 않습니다. 구문 분석될 문자열에서 이러한 요소를 허용하려면 AllowDecimalPointAllowLeadingSign 플래그를 사용하거나 이러한 개별 플래그가 포함된 복합 스타일을 사용합니다.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

숫자 문자열이 16진수 값을 나타낸다는 것을 나타냅니다.Indicates that the numeric string represents a hexadecimal value. 유효한 16진수 값은 0부터 9까지의 숫자와 A부터 F 및 a부터 f까지의 16진 문자를 포함합니다.Valid hexadecimal values include the numeric digits 0-9 and the hexadecimal digits A-F and a-f. 이 스타일을 사용하여 구문 분석되는 문자열에는 "0x" 또는 "&h" 접두사를 사용할 수 없습니다.Strings that are parsed using this style cannot be prefixed with "0x" or "&h". AllowHexSpecifier 스타일을 사용하여 구문 분석된 문자열은 항상 16진수 값으로 해석됩니다.A string that is parsed with the AllowHexSpecifier style will always be interpreted as a hexadecimal value. AllowHexSpecifier와 함께 사용할 수 있는 플래그는 AllowLeadingWhiteAllowTrailingWhite뿐입니다.The only flags that can be combined with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. NumberStyles 열거형에는 이러한 세 플래그로 구성된 복합 스타일인 HexNumber가 포함됩니다.The NumberStyles enumeration includes a composite style, HexNumber, that consists of these three flags.

AllowLeadingSign 4

숫자 문자열에 선행 부호가 있을 수 있음을 나타냅니다.Indicates that the numeric string can have a leading sign. 유효한 선행 부호 문자는 PositiveSignNegativeSign 속성으로 결정됩니다.Valid leading sign characters are determined by the PositiveSign and NegativeSign properties.

AllowLeadingWhite 1

구문 분석된 문자열에 선행 공백 문자를 사용할 수 있음을 나타냅니다.Indicates that leading white-space characters can be present in the parsed string. 공백 문자의 유니코드 값은 U+0009, U+000A, U+000B, U+000C, U+000D 및 U+0020입니다.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. 이는 IsWhiteSpace(Char) 메서드가 true를 반환하는 문자의 하위 집합입니다.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

AllowParentheses 16

숫자 문자열에 숫자를 둘러싸는 한 쌍의 괄호가 있을 수 있음을 나타냅니다.Indicates that the numeric string can have one pair of parentheses enclosing the number. 괄호는 구문 분석될 문자열이 음수를 나타냄을 나타냅니다.The parentheses indicate that the string to be parsed represents a negative number.

AllowThousands 64

숫자 문자열에 1000 단위를 구분하는 기호와 같은 그룹 구분 기호가 있을 수 있음을 나타냅니다.Indicates that the numeric string can have group separators, such as symbols that separate hundreds from thousands. NumberStyles 값에 AllowCurrencySymbol 플래그가 포함되고 구문 분석할 문자열에 통화 기호가 포함된 경우 유효한 그룹 구분 기호 문자는 CurrencyGroupSeparator 속성으로 결정되고 각 그룹의 자릿수는 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. 그렇지 않으면 유효한 그룹 구분 문자가 NumberGroupSeparator 속성으로 결정되며 각 그룹의 자릿수는 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

숫자 문자열에 후행 부호가 있을 수 있음을 나타냅니다.Indicates that the numeric string can have a trailing sign. 유효한 후행 부호 문자는 PositiveSignNegativeSign 속성으로 결정됩니다.Valid trailing sign characters are determined by the PositiveSign and NegativeSign properties.

AllowTrailingWhite 2

구문 분석된 문자열에 후행 공백 문자를 사용할 수 있음을 나타냅니다.Indicates that trailing white-space characters can be present in the parsed string. 공백 문자의 유니코드 값은 U+0009, U+000A, U+000B, U+000C, U+000D 및 U+0020입니다.Valid white-space characters have the Unicode values U+0009, U+000A, U+000B, U+000C, U+000D, and U+0020. 이는 IsWhiteSpace(Char) 메서드가 true를 반환하는 문자의 하위 집합입니다.Note that this is a subset of the characters for which the IsWhiteSpace(Char) method returns true.

Any 511

AllowHexSpecifier를 제외한 모든 스타일을 사용함을 나타냅니다.Indicates that all styles except AllowHexSpecifier are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

Currency 383

AllowExponentAllowHexSpecifier를 제외한 모든 스타일을 사용함을 나타냅니다.Indicates that all styles except AllowExponent and AllowHexSpecifier are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

Float 167

AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPointAllowExponent 스타일을 사용함을 나타냅니다.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowDecimalPoint, and AllowExponent styles are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

HexNumber 515

AllowLeadingWhite, AllowTrailingWhiteAllowHexSpecifier 스타일을 사용함을 나타냅니다.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowHexSpecifier styles are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

Integer 7

AllowLeadingWhite, AllowTrailingWhiteAllowLeadingSign 스타일을 사용함을 나타냅니다.Indicates that the AllowLeadingWhite, AllowTrailingWhite, and AllowLeadingSign styles are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

None 0

구문 분석된 문자열에 선행 또는 후행 공백, 1000단위 구분 기호, 소수 구분 기호와 같은 스타일 요소가 있을 수 없다는 것을 나타냅니다.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. 구문 분석될 문자열은 정수로만 구성되어야 합니다.The string to be parsed must consist of integral decimal digits only.

Number 111

AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPointAllowThousands 스타일을 사용함을 나타냅니다.Indicates that the AllowLeadingWhite, AllowTrailingWhite, AllowLeadingSign, AllowTrailingSign, AllowDecimalPoint, and AllowThousands styles are used. 이것은 복합 숫자 스타일입니다.This is a composite number style.

예제

이 예제에서는 다양 한를 사용 하 여 32 비트 정수에 문자열을 구문 분석 하는 방법을 보여 줍니다 NumberStyles 플래그입니다.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'.

설명

NumberStyles 두 종류의 숫자 값의 문자열 표현을 구문 분석 하는 데 사용 되는 열거형 값의 열거형으로 구성 됩니다.The NumberStyles enumeration consists of two kinds of enumeration values that are used to parse the string representations of numeric values:

  • 구문 분석된 된 문자열에 나타날 수 있는 특정 스타일 요소 (예: 공백, 그룹 구분 기호)을 정의 하는 개별 필드 플래그입니다.Individual field flags, which define specific style elements (such as white space and group separators) that can be present in the parsed string.

  • 구문 분석된 된 문자열에 나타날 수 있는 스타일 요소를 정의 하는 여러 필드 플래그 이루어진 복합 숫자 스타일입니다.Composite number styles, which consist of multiple field flags that define the style elements that can be present in the parsed string.

를 제외 하 고 NumberStyles ,열거형의개별필드플래그는10진수의문자열표현을구문분석할때사용되는스타일요소를정의합니다.AllowHexSpecifierExcept 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. None구문 분석 된 문자열에 숫자만 사용할 수 있음을 나타냅니다.None indicates that only digits can be present in the parsed string. 나머지 개별 필드 플래그를 제공할 수 있지만 성공 하려면 구문 분석 작업에 대 한 10 진수 숫자의 문자열 표현에서 제공할 필요가 없습니다 있는 스타일 요소를 정의 합니다.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. 반대로 플래그는 AllowHexSpecifier 구문 분석할 문자열이 항상 16 진수 값으로 해석 됨을 나타냅니다.In contrast, the AllowHexSpecifier flag indicates that the string to be parsed is always interpreted as a hexadecimal value. 에서 사용할 AllowHexSpecifier AllowTrailingWhite수 있는 개별 필드 플래그는 및뿐입니다.AllowLeadingWhiteThe only individual field flags that can be used with AllowHexSpecifier are AllowLeadingWhite and AllowTrailingWhite. 열거형 NumberStyles 에는 세 가지 플래그 모두로 HexNumber구성 된 복합 숫자 스타일가 포함 되어 있습니다.The NumberStyles enumeration includes a composite number style, HexNumber, that consists of all three flags.

구문 분석할 문자열에 나타날 수 있습니다 (예: 통화 기호, 그룹 구분 기호, 소수 구분 기호 및 양수 기호와 음수 기호) 기호는의 멤버에 의해 정의 된 System.Globalization.NumberFormatInfo 암시적 또는 명시적으로 전달 되는 개체 에 Parse 메서드.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. 이 항목의 멤버 표에서 각 개별 플래그에 대 한 설명을 제공 하 고의 관계를 나타냅니다 NumberFormatInfo 속성입니다.The members table in this topic provides a description of each individual flag and indicates its relationship to NumberFormatInfo properties.

다음 표에서 복합 숫자 스타일을 나열 하 고 포함 하는 개별 필드 플래그를 나타냅니다.The following table lists the composite number styles and indicates which individual field flags they include. 셀에 "1" 복합 숫자 스타일을 해당 행에서 개별 숫자 스타일을 포함 함을 나타냅니다.A "1" in a cell indicates that the composite number style includes the individual number style in that row. "0"은 복합 숫자 스타일 개별 숫자 스타일이 포함 되지 않습니다 나타냅니다.A "0" indicates that the composite number style does not include the individual number style.

임의의 값Any 통화Currency FloatFloat 정수Integer Number 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)

적용 대상

추가 정보