BigInteger.Parse BigInteger.Parse BigInteger.Parse BigInteger.Parse Method

정의

숫자의 문자열 표현을 해당하는 BigInteger로 변환합니다.Converts the string representation of a number to its BigInteger equivalent.

오버로드

Parse(String) Parse(String) Parse(String) Parse(String)

숫자의 문자열 표현을 해당하는 BigInteger로 변환합니다.Converts the string representation of a number to its BigInteger equivalent.

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

숫자를 지정된 스타일로 나타낸 문자열 표현을 해당 BigInteger로 변환합니다.Converts the string representation of a number in a specified style to its BigInteger equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

숫자를 지정된 문화권별 형식으로 나타낸 문자열 표현을 해당 BigInteger로 변환합니다.Converts the string representation of a number in a specified culture-specific format to its BigInteger equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 BigInteger로 변환합니다.Converts the string representation of a number in a specified style and culture-specific format to its BigInteger equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

숫자의 문자열 표현을 해당하는 BigInteger로 변환합니다.Converts the string representation of a number to its BigInteger equivalent.

public:
 static System::Numerics::BigInteger Parse(System::String ^ value);
public static System.Numerics.BigInteger Parse (string value);
static member Parse : string -> System.Numerics.BigInteger
Public Shared Function Parse (value As String) As BigInteger

매개 변수

value
String String String String

변환할 숫자가 포함된 문자열입니다.A string that contains the number to convert.

반환

value 매개 변수에 지정된 숫자에 해당하는 값입니다.A value that is equivalent to the number specified in the value parameter.

예외

value가 올바른 형식이 아닙니다.value is not in the correct format.

예제

다음 예제에서는 합니다 Parse(String) 메서드를 두 BigInteger 개체입니다.The following example uses the Parse(String) method to instantiate two BigInteger objects. 각 개체는 다른 수를 곱하고 그 다음 호출을 Compare 두 값 간의 관계를 확인 하는 방법입니다.It multiplies each object by another number and then calls the Compare method to determine the relationship between the two values.

string stringToParse = String.Empty;
try
{
   // Parse two strings.
   string string1, string2;
   string1 = "12347534159895123";
   string2 = "987654321357159852";
   stringToParse = string1;
   BigInteger number1 = BigInteger.Parse(stringToParse);
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number1);        
   stringToParse = string2;
   BigInteger number2 = BigInteger.Parse(stringToParse);
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number2);
   // Perform arithmetic operations on the two numbers.
   number1 *= 3;
   number2 *= 2;
   // Compare the numbers.
   int result = BigInteger.Compare(number1, number2);
   switch (result)
   {
      case -1:
         Console.WriteLine("{0} is greater than {1}.", number2, number1);
         break;
      case 0:
         Console.WriteLine("{0} is equal to {1}.", number1, number2);
         break;
      case 1:
         Console.WriteLine("{0} is greater than {1}.", number1, number2);
         break;
   }      
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse {0}.", stringToParse);
}
// The example displays the following output:
//    Converted '12347534159895123' to 12,347,534,159,895,123.
//    Converted '987654321357159852' to 987,654,321,357,159,852.
//    1975308642714319704 is greater than 37042602479685369.      
Dim stringToParse As String = String.Empty
Try
   ' Parse two strings.
   Dim string1, string2 As String
   string1 = "12347534159895123"
   string2 = "987654321357159852"
   stringToParse = string1
   Dim number1 As BigInteger = BigInteger.Parse(stringToParse)
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number1)
   stringToParse = string2
   Dim number2 As BigInteger = BigInteger.Parse(stringToParse)
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number2)
   ' Perform arithmetic operations on the two numbers.
   number1 *= 3
   number2 *= 2
   ' Compare the numbers.
   Select Case BigInteger.Compare(number1, number2)
      Case -1
         Console.WriteLine("{0} is greater than {1}.", number2, number1)
      Case 0
         Console.WriteLine("{0} is equal to {1}.", number1, number2)
      Case 1
         Console.WriteLine("{0} is greater than {1}.", number1, number2)
   End Select      
Catch e As FormatException
   Console.WriteLine("Unable to parse {0}.", stringToParse)
End Try
' The example displays the following output:
'    Converted '12347534159895123' to 12,347,534,159,895,123.
'    Converted '987654321357159852' to 987,654,321,357,159,852.
'    1975308642714319704 is greater than 37042602479685369.      

설명

value 매개 변수 형식은 숫자의 문자열 표현 이어야 합니다.The value parameter should be the string representation of a number in the following form.

[ws][sign]digits[ws][ws][sign]digits[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space.
signsign 가 선택적 부호입니다.An optional sign. 유효한 부호 문자는 기준 합니다 NumberFormatInfo.NegativeSignNumberFormatInfo.PositiveSign 현재 문화권의 속성입니다.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
digitsdigits 0에서 9 까지의 숫자 시퀀스입니다.A sequence of digits ranging from 0 to 9. 모든 선행 0은 무시 됩니다.Any leading zeros are ignored.

참고

지정 된 문자열을 value 매개 변수를 사용 하 여 해석 됩니다는 NumberStyles.Integer 스타일입니다.The string specified by the value parameter is interpreted by using the NumberStyles.Integer style. 그룹 구분 기호나 소수 구분 기호를 포함할 수 없습니다 하며에 소수 부분이 없습니다.It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

value 매개 변수에서 서식 지정 정보를 사용 하 여 구문 분석 되는 System.Globalization.NumberFormatInfo 현재 시스템 문화권에 대 한 초기화 되는 개체입니다.The value parameter is parsed by using the formatting information in a System.Globalization.NumberFormatInfo object that is initialized for the current system culture. 자세한 내용은 NumberFormatInfo.CurrentInfo을 참조하세요.For more information, see NumberFormatInfo.CurrentInfo. 특정 문화권의 서식 지정 정보를 사용 하 여 문자열의 구문을 분석을 사용 하 여를 Parse(String, IFormatProvider) 메서드.To parse a string by using the formatting information of a specific culture, use the Parse(String, IFormatProvider) method.

중요

사용 하는 경우는 Parse 왕복 문자열 표현 하기 위해의를 BigInteger 의해 출력 된 값을 ToString 메서드를 사용할지를 BigInteger.ToString(String) 의 문자열 표현을 생성 "R" 서식 지정자를 사용 하 여 메서드를 BigInteger 값입니다.If you use the Parse method to round-trip the string representation of a BigInteger value that was output by the ToString method, you should use the BigInteger.ToString(String) method with the "R" format specifier to generate the string representation of the BigInteger value. 이 고, 그렇지의 문자열 표현 합니다 BigInteger 50 사용 하는 경우 원래 값 및 데이터의 최대 유효 자릿수 손실 될 수 있습니다만 유지 합니다 Parse 복원 하는 방법을 BigInteger 값.Otherwise, the string representation of the BigInteger preserves only the 50 most significant digits of the original value, and data may be lost when you use the Parse method to restore the BigInteger value.

추가 정보

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

숫자를 지정된 스타일로 나타낸 문자열 표현을 해당 BigInteger로 변환합니다.Converts the string representation of a number in a specified style to its BigInteger equivalent.

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, System::Globalization::NumberStyles style);
public static System.Numerics.BigInteger Parse (string value, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> System.Numerics.BigInteger
Public Shared Function Parse (value As String, style As NumberStyles) As BigInteger

매개 변수

value
String String String String

변환할 숫자가 포함된 문자열입니다.A string that contains a number to convert.

style
NumberStyles NumberStyles NumberStyles NumberStyles

value에 사용할 수 있는 서식을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify the permitted format of value.

반환

value 매개 변수에 지정된 숫자에 해당하는 값입니다.A value that is equivalent to the number specified in the value parameter.

예외

styleNumberStyles 값이 아닙니다.style is not a NumberStyles value.

또는-or- style에는 AllowHexSpecifier 또는 HexNumber 플래그가 다른 값과 함께 포함됩니다.style includes the AllowHexSpecifier or HexNumber flag along with another value.

valueNumberStyles에 의해 지정된 입력 패턴에 맞지 않습니다.value does not comply with the input pattern specified by NumberStyles.

예제

다음 예제에 대 한 호출을 Parse(String, NumberStyles) 에 대 한 몇 가지 가능한 값을 사용 하 여 메서드를 style 매개 변수.The following example illustrates calls to the Parse(String, NumberStyles) method with several possible values for the style parameter. 16 진수 값으로 문자열을 해석 하는 방법 및 공간을 허용 하지 않습니다 하 고 기호를 서명 하는 방법을 보여 줍니다.It illustrates how to interpret a string as a hexadecimal value, and how to disallow spaces and sign symbols.

BigInteger number; 
// Method should succeed (white space and sign allowed)
number = BigInteger.Parse("   -68054   ", NumberStyles.Integer);
Console.WriteLine(number);
// Method should succeed (string interpreted as hexadecimal)
number = BigInteger.Parse("68054", NumberStyles.AllowHexSpecifier);
Console.WriteLine(number);
// Method call should fail: sign not allowed
try
{
   number = BigInteger.Parse("   -68054  ", NumberStyles.AllowLeadingWhite 
                                            | NumberStyles.AllowTrailingWhite);
   Console.WriteLine(number);
}   
catch (FormatException e)
{
   Console.WriteLine(e.Message);
}                                                     
// Method call should fail: white space not allowed
try
{
   number = BigInteger.Parse("   68054  ", NumberStyles.AllowLeadingSign);
   Console.WriteLine(number);
}
catch (FormatException e)
{
   Console.WriteLine(e.Message);
}    
//
// The method produces the following output:
//
//     -68054
//     426068
//     Input string was not in a correct format.
//     Input string was not in a correct format.                                                 
Dim number As BigInteger 
' Method should succeed (white space and sign allowed)
number = BigInteger.Parse("   -68054   ", NumberStyles.Integer)
Console.WriteLine(number)
' Method should succeed (string interpreted as hexadecimal)
number = BigInteger.Parse("68054", NumberStyles.AllowHexSpecifier)
Console.WriteLine(number)
' Method call should fail: sign not allowed
Try
   number = BigInteger.Parse("   -68054  ", NumberStyles.AllowLeadingWhite _
                                            Or NumberStyles.AllowTrailingWhite)
   Console.WriteLine(number)
Catch e As FormatException
   Console.WriteLine(e.Message)
End Try                                                     
' Method call should fail: white space not allowed
Try
   number = BigInteger.Parse("   68054  ", NumberStyles.AllowLeadingSign)
   Console.WriteLine(number)
Catch e As FormatException
   Console.WriteLine(e.Message)
End Try    
'
' The method produces the following output:
'
'     -68054
'     426068
'     Input string was not in a correct format.
'     Input string was not in a correct format.                                                 

설명

합니다 style 매개 변수 (예: 공백, 양수 또는 음수 기호, 그룹 구분 기호 또는 소수점 기호)에 사용할 수 있는 스타일 요소를 정의 합니다 value 구문 분석 작업이 성공 하기 위해 매개 변수입니다.The style parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the value parameter for the parse operation to succeed. styles 비트 플래그 조합 이어야 합니다는 NumberStyles 열거형입니다.styles must be a combination of bit flags from the NumberStyles enumeration. 합니다 style 매개 변수 오버 로드 유용할 경우 이러한 메서드를 만듭니다 value 수 시스템 (10 진수 또는 16 진수)을 나타내는 16 진수 값의 문자열 표현이 포함 되어 value 실행된 시간에만 알려진 때나 있습니다 공백 문자를 허용 하지 않도록 하거나 부호 기호를 value입니다.The style parameter makes this method overload useful when value contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by value is known only at run time, or when you want to disallow white space or a sign symbol in value.

값에 따라 style, value 매개 변수는 다음 요소가 포함 될 수 있습니다.Depending on the value of style, the value parameter may include the following elements:

[ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

하는 경우 style 포함 NumberStyles.AllowHexSpecifier, value 매개 변수는 다음 요소가 포함 될 수 있습니다.If style includes NumberStyles.AllowHexSpecifier, the value parameter may contain the following elements:

[ws]hexdigits[ws][ws]hexdigits[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 공백의 시작 부분에 나타날 수 있습니다 value 경우 style 포함 합니다 NumberStyles.AllowLeadingWhite 끝에 있고, 나타날 수 있습니다 value 경우 style 포함를 NumberStyles.AllowTrailingWhite 플래그 합니다.White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열에 해당 위치는 NumberFormatInfo.CurrencyNegativePatternNumberFormatInfo.CurrencyPositivePattern 현재 문화권의 속성입니다.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. 현재 문화권의 통화 기호에 나타날 수 있습니다 value 하는 경우 style 포함 된 NumberStyles.AllowCurrencySymbol 플래그 합니다.The current culture's currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 로그인의 시작 부분에 나타날 수 있습니다 value 경우 style 포함 합니다 NumberStyles.AllowLeadingSign 끝에 있고, 나타날 수 있습니다 value 경우 style 포함를 NumberStyles.AllowTrailingSign 플래그.The sign can appear at the start of value if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingSign flag. 괄호를 사용할 수 있습니다 value 경우 음수 값을 나타내는 데 style 포함 된 NumberStyles.AllowParentheses 플래그입니다.Parentheses can be used in value to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9. 에 대 한 소수 자릿수숫자 0 유효만 합니다.For fractional_digits, only the digit 0 is valid.
,, Culture 별 그룹 구분 기호입니다.A culture-specific group separator symbol. 현재 문화권의 그룹 구분 기호에 나타날 수 있습니다 value 하는 경우 style 포함 된 NumberStyles.AllowThousands 플래그입니다.The current culture's group separator can appear in value if style includes the NumberStyles.AllowThousands flag.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. 현재 문화권의 소수점 기호에 나타날 수 있습니다 value 경우 style 포함 된 NumberStyles.AllowDecimalPoint 플래그입니다.The current culture's decimal point symbol can appear in value if style includes the NumberStyles.AllowDecimalPoint flag. 구문 분석 작업이 성공 하기 위해 소수 자릿수로 숫자 0만 나타날 수 있습니다. 경우 소수 자릿수 다른 숫자를 포함 한 FormatException throw 됩니다.Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, a FormatException is thrown.
EE "E" 또는 "E" 문자 값은 지 수 (과학적 표기법) 표기법으로 표현 됨을 나타내는입니다.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. value 매개 변수는 경우 지 수 표기법으로 숫자를 나타낼 수 style 포함 된 NumberStyles.AllowExponent 플래그.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 16 진수 숫자 0 ~ f 또는 0 ~ 6. 시퀀스A sequence of hexadecimal digits from 0 through f, or 0 through F.

참고

종료 NUL (U + 0000)에 임의 문자를 s 의 값에 관계 없이 구문 분석 작업에서 무시 되는 style 인수입니다.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

숫자만 문자열 (해당 하는 NumberStyles.None 스타일) 항상 성공적으로 구문 분석 합니다.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. 나머지 대부분 NumberStyles 멤버가 있을 수 있지만 입력된 문자열에 나타날 수 필요가 없습니다 요소를 제어할 수 있습니다.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in the input string. 다음 표에서 개별 NumberStyles 멤버에 나타날 수 있는 요소에 영향을 줄 value합니다.The following table indicates how individual NumberStyles members affect the elements that may be present in value.

NumberStylesNumberStyles value 허용 되는 요소 value 숫자 외에도Elements permitted in value in addition to digits
None 합니다 자릿수 요소에만 합니다.The digits element only.
AllowDecimalPoint 소수점 (.) 및 소수 자릿수 요소입니다.The decimal point (.) and fractional-digits elements.
AllowExponent "E" 또는 "E" 문자를 함께 지 수 표기법으로 나타냅니다 지 수 표기법합니다.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
AllowLeadingWhite 합니다 ws 의 시작 부분에 요소 value합니다.The ws element at the start of value.
AllowTrailingWhite 합니다 ws 의 끝에 있는 요소 value합니다.The ws element at the end of value.
AllowLeadingSign 합니다 sign 의 시작 부분에 요소 value합니다.The sign element at the start of value.
AllowTrailingSign 합니다 sign 의 끝에 있는 요소 value합니다.The sign element at the end of value.
AllowParentheses 합니다 기호 형식의 숫자 값을 묶는 괄호는 요소입니다.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element.
AllowCurrencySymbol 통화 ($) 요소입니다.The currency ($) element.
Currency 모든 요소입니다.All elements. 그러나 value 16 진수 또는 지 수 표기법으로 숫자를에서 나타낼 수 없습니다.However, value cannot represent a hexadecimal number or a number in exponential notation.
Float value** 의 시작 또는 끝 부분에 있는 ws 요소,의 시작 부분에 있는 기호 및 소수점 (.) 기호를 지정 합니다. valueThe ws element at the start or end of value, sign at the start of value, and the decimal point (.) symbol. value 매개 변수 지 수 표기법을 사용할 수도 있습니다.The value parameter can also use exponential notation.
Number ws, sign, 그룹 구분 기호 (,), 소수점 및 (.) 요소입니다.The ws, sign, group separator (,), and decimal point (.) elements.
Any 모든 요소입니다.All elements. 그러나 value 16 진수 숫자를 나타낼 수 없습니다.However, value cannot represent a hexadecimal number.

중요

사용 하는 경우는 Parse 왕복 문자열 표현 하기 위해의를 BigInteger 의해 출력 된 값을 ToString 메서드를 사용할지를 BigInteger.ToString(String) 의 문자열 표현을 생성 "R" 서식 지정자를 사용 하 여 메서드를 BigInteger 값입니다.If you use the Parse method to round-trip the string representation of a BigInteger value that was output by the ToString method, you should use the BigInteger.ToString(String) method with the "R" format specifier to generate the string representation of the BigInteger value. 이 고, 그렇지의 문자열 표현 합니다 BigInteger 50 사용 하는 경우 원래 값 및 데이터의 최대 유효 자릿수 손실 될 수 있습니다만 유지 합니다 Parse 복원 하는 방법을 BigInteger 값.Otherwise, the string representation of the BigInteger preserves only the 50 most significant digits of the original value, and data may be lost when you use the Parse method to restore the BigInteger value.

다른 달리 NumberStyles 값을 허용 하지만 특정 스타일 요소에 있으면 필요 하지 않습니다 valueNumberStyles.AllowHexSpecifier 스타일 값의 개별 숫자 문자를 의미 value 항상로 해석 됩니다 16 진수 문자입니다.Unlike the other NumberStyles values, which allow for, but do not require, the presence of particular style elements in value, the NumberStyles.AllowHexSpecifier style value means that the individual numeric characters in value are always interpreted as hexadecimal characters. 유효한 16 진수는 0-9, A-f 및 a-f 문자입니다.Valid hexadecimal characters are 0-9, A-F, and a-f. 만 다른 플래그와 결합 될 수 있는 합니다 style 매개 변수에 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite합니다.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (합니다 NumberStyles 열거형은 복합 숫자 스타일을 포함 HexNumber, 모두 공백 플래그를 포함 하는.)(The NumberStyles enumeration includes a composite number style, HexNumber, that includes both white-space flags.)

참고

하는 경우 value 문자열 표현인 16 진수 숫자의 고 수 없습니다. 뒤에 야 모든 장식 (같은 0x 또는 &h) 16 진수 숫자로 구분 하는 합니다.If value is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. 이렇게 하면 변환이 실패할 수 있습니다.This causes the conversion to fail.

경우 value 16 진수 문자열을 Parse(String, NumberStyles) 보다 크거나 같습니다 value 음수로 처음 두 16 진수 보다 크거나 같은 경우에 2의 보수 표현이 사용 하 여 저장 0x80합니다.If value is a hexadecimal string, the Parse(String, NumberStyles) method interprets value as a negative number stored by using two's complement representation if its first two hexadecimal digits are greater than or equal to 0x80. 메서드는 첫 번째 바이트의 최상위 비트를 해석 하는 즉, value 부호 비트로입니다.In other words, the method interprets the highest-order bit of the first byte in value as the sign bit. 16 진수 문자열에서 첫 번째 숫자가 양수 숫자로 해석 됩니다 있도록 value 0의 값이 있어야 합니다.To make sure that a hexadecimal string is correctly interpreted as a positive number, the first digit in value must have a value of zero. 예를 들어이 메서드는 해석 0x80 음수 값을 해석 하거나 대로 0x080 또는 0x0080 양수 값으로.For example, the method interprets 0x80 as a negative value, but it interprets either 0x080 or 0x0080 as a positive value. 다음 예에서는 양수 및 음수 값을 나타내는 16 진수 문자열 간의 차이점을 보여 줍니다.The following example illustrates the difference between hexadecimal strings that represent negative and positive values.

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                              "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                              "0080", "00E293", "00F9A2FF", "00FFFFFFFF" };
      foreach (string hexString in hexStrings)
      {
         BigInteger number = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
      }         
   }
}
// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.
Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim hexStrings() As String = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                                     "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                                     "0080", "00E293", "00F9A2FF", "00FFFFFFFF" }
      For Each hexString As String In hexStrings
         Dim number As BigInteger = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
      Next         
   End Sub
End Module
' The example displays the following output:
'       Converted 0x80 to -128.
'       Converted 0xE293 to -7533.
'       Converted 0xF9A2FF to -417025.
'       Converted 0xFFFFFFFF to -1.
'       Converted 0x080 to 128.
'       Converted 0x0E293 to 58003.
'       Converted 0x0F9A2FF to 16360191.
'       Converted 0x0FFFFFFFF to 4294967295.
'       Converted 0x0080 to 128.
'       Converted 0x00E293 to 58003.
'       Converted 0x00F9A2FF to 16360191.
'       Converted 0x00FFFFFFFF to 4294967295.

value 매개 변수에서 서식 지정 정보를 사용 하 여 구문 분석 되는 NumberFormatInfo 현재 시스템 문화권에 대 한 초기화 되는 개체입니다.The value parameter is parsed by using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. 서식 지정 정보를 가져올 구문 분석 작업에 사용 되는 문화권을 지정 하려면 호출을 Parse(String, NumberStyles, IFormatProvider) 오버 로드 합니다.To specify the culture whose formatting information is used for the parse operation, call the Parse(String, NumberStyles, IFormatProvider) overload.

추가 정보

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

숫자를 지정된 문화권별 형식으로 나타낸 문자열 표현을 해당 BigInteger로 변환합니다.Converts the string representation of a number in a specified culture-specific format to its BigInteger equivalent.

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, IFormatProvider ^ provider);
public static System.Numerics.BigInteger Parse (string value, IFormatProvider provider);
static member Parse : string * IFormatProvider -> System.Numerics.BigInteger
Public Shared Function Parse (value As String, provider As IFormatProvider) As BigInteger

매개 변수

value
String String String String

변환할 숫자가 포함된 문자열입니다.A string that contains a number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

value에 대한 문화권별 서식 정보를 제공하는 개체입니다.An object that provides culture-specific formatting information about value.

반환

value 매개 변수에 지정된 숫자에 해당하는 값입니다.A value that is equivalent to the number specified in the value parameter.

예외

value가 올바른 형식이 아닙니다.value is not in the correct format.

예제

다음 예제에서는 서식 지정에 대 한 음수 부호로 물결표 (~)를 정의 하는 방법을 보여 줍니다 BigInteger 값입니다.The following examples show two ways to define the tilde (~) as a negative sign for formatting BigInteger values. 표시 하는 합니다 BigInteger 같은 형식으로 원본 문자열 값을 코드를 호출 해야 합니다는 BigInteger.ToString(IFormatProvider) 메서드 전달는 NumberFormatInfo 서식 지정 정보를 제공 하는 개체입니다.Note that to display the BigInteger values in the same format as the original strings, your code must call the BigInteger.ToString(IFormatProvider) method and pass it the NumberFormatInfo object that provides formatting information.

구현 하는 클래스를 정의 하는 첫 번째 예제 IFormatProvider 사용 하는 GetFormat 반환 하는 방법의 NumberFormatInfo 서식 지정 정보를 제공 하는 개체.The first example defines a class that implements IFormatProvider and uses the GetFormat method to return the NumberFormatInfo object that provides formatting information.

public class BigIntegerFormatProvider : IFormatProvider
{
   public object GetFormat(Type formatType) 
   {
      if (formatType == typeof(NumberFormatInfo)) 
      {
         NumberFormatInfo numberFormat = new NumberFormatInfo();
         numberFormat.NegativeSign = "~";
         return numberFormat;
      }
      else
      {
         return null;
      }      
   }
}
Public Class BigIntegerFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                            Implements IFormatProvider.GetFormat
      If formatType Is GetType(NumberFormatInfo) Then
         Dim numberFormat As New NumberFormatInfo
         numberFormat.NegativeSign = "~"
         Return numberFormat
      Else
         Return Nothing
      End If      
   End Function
End Class

BigInteger 다음 코드를 사용 하 여 개체를 인스턴스화할 수 있습니다.A BigInteger object can then be instantiated with the following code:

BigInteger number = BigInteger.Parse("~6354129876", new BigIntegerFormatProvider());
// Display value using same formatting information
Console.WriteLine(number.ToString(new BigIntegerFormatProvider()));
// Display value using formatting of current culture
Console.WriteLine(number);
Dim number As BigInteger = BigInteger.Parse("~6354129876", New BigIntegerFormatProvider)
' Display value using same formatting information
Console.WriteLine(number.ToString(New BigIntegerFormatProvider))
' Display value using formatting of current culture
Console.WriteLine(number)

두 번째 예제는 더 간단 합니다.The second example is more straightforward. 전달 된 NumberFormatInfo 서식 지정 정보를 제공 하는 개체는 provider 매개 변수입니다.It passes the NumberFormatInfo object that provides formatting information to the provider parameter.

NumberFormatInfo fmt = new NumberFormatInfo();
fmt.NegativeSign = "~";

BigInteger number = BigInteger.Parse("~6354129876", fmt);
// Display value using same formatting information
Console.WriteLine(number.ToString(fmt));
// Display value using formatting of current culture
Console.WriteLine(number);
Dim fmt As New NumberFormatInfo()
fmt.NegativeSign = "~"

Dim number As BigInteger = BigInteger.Parse("~6354129876", fmt)
' Display value using same formatting information
Console.WriteLine(number.ToString(fmt))
' Display value using formatting of current culture
Console.WriteLine(number)

설명

value 매개 변수 형식은 숫자의 문자열 표현 이어야 합니다.The value parameter should be the string representation of a number in the following form:

[ws][sign]digits[ws][ws][sign]digits[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space.
signsign 가 선택적 부호입니다.An optional sign. 유효한 부호 문자에 의해 결정 됩니다는 NumberFormatInfo.NegativeSignNumberFormatInfo.PositiveSign 의 속성을 NumberFormatInfo 에서 반환 되는 개체를 provider 개체의 GetFormat 메서드.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the NumberFormatInfo object that is returned by the provider object's GetFormat method.
digitsdigits 0에서 9 까지의 숫자 시퀀스입니다.A sequence of digits ranging from 0 to 9. 모든 선행 0은 무시 됩니다.Any leading zeros are ignored.

참고

지정 된 문자열을 value 매개 변수를 사용 하 여 해석 됩니다는 NumberStyles.Integer 스타일입니다.The string specified by the value parameter is interpreted using the NumberStyles.Integer style. 그룹 구분 기호나 소수 구분 기호를 포함할 수 없습니다 하며에 소수 부분이 없습니다.It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

중요

사용 하는 경우는 Parse 왕복 문자열 표현 하기 위해의를 BigInteger 의해 출력 된 값을 ToString 메서드를 사용할지를 BigInteger.ToString(String) 의 문자열 표현을 생성 "R" 서식 지정자를 사용 하 여 메서드를 BigInteger 값입니다.If you use the Parse method to round-trip the string representation of a BigInteger value that was output by the ToString method, you should use the BigInteger.ToString(String) method with the "R" format specifier to generate the string representation of the BigInteger value. 이 고, 그렇지의 문자열 표현 합니다 BigInteger 50 사용 하는 경우 원래 값 및 데이터의 최대 유효 자릿수 손실 될 수 있습니다만 유지 합니다 Parse 복원 하는 방법을 BigInteger 값.Otherwise, the string representation of the BigInteger preserves only the 50 most significant digits of the original value, and data may be lost when you use the Parse method to restore the BigInteger value.

provider 매개 변수는는 IFormatProvider 구현입니다 GetFormat 메서드가 반환 되는 NumberFormatInfo culture 별 서식 지정 정보를 제공 하는 개체.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. 경우는 Parse(String, IFormatProvider) 메서드가 호출 되 면 호출를 provider 매개 변수의 GetFormat 메서드 전달를 Type 나타내는 개체를 NumberFormatInfo 형식.When the Parse(String, IFormatProvider) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. GetFormat 메서드가 반환 됩니다 합니다 NumberFormatInfo 개체의 형식에 대 한 정보를 제공 하는 value 매개 변수입니다.The GetFormat method then returns the NumberFormatInfo object that provides information about the format of the value parameter. 사용 하는 방법은 세 가지를 provider 매개 변수를 구문 분석 작업에 사용자 지정 서식 지정 정보를 제공 합니다.There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 전달할 수는 CultureInfo 서식 지정 정보를 제공 하는 문화권을 나타내는 개체입니다.You can pass a CultureInfo object that represents the culture that supplies formatting information. 해당 GetFormat 메서드가 반환 되는 NumberFormatInfo 해당 문화권에 대 한 숫자 형식 지정 정보를 제공 하는 개체입니다.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • 실제 전달할 수 있습니다 NumberFormatInfo 숫자 형식 지정 정보를 제공 하는 개체입니다.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (해당 구현의 GetFormat 자체를 반환 합니다.)(Its implementation of GetFormat just returns itself.)

  • 구현 하는 사용자 지정 개체를 전달할 수 있습니다 IFormatProvider합니다.You can pass a custom object that implements IFormatProvider. 해당 GetFormat 메서드를 인스턴스화하고 반환 된 NumberFormatInfo 서식 지정 정보를 제공 하는 개체입니다.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

경우 provider 됩니다 null의 서식을 value 기준으로 해석 됩니다는 NumberFormatInfo 현재 문화권의 개체입니다.If provider is null, the formatting of value is interpreted based on the NumberFormatInfo object of the current culture.

추가 정보

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

public static System.Numerics.BigInteger Parse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> System.Numerics.BigInteger
Public Shared Function Parse (value As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As BigInteger

매개 변수

반환

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 BigInteger로 변환합니다.Converts the string representation of a number in a specified style and culture-specific format to its BigInteger equivalent.

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public static System.Numerics.BigInteger Parse (string value, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> System.Numerics.BigInteger
Public Shared Function Parse (value As String, style As NumberStyles, provider As IFormatProvider) As BigInteger

매개 변수

value
String String String String

변환할 숫자가 포함된 문자열입니다.A string that contains a number to convert.

style
NumberStyles NumberStyles NumberStyles NumberStyles

value에 사용할 수 있는 서식을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify the permitted format of value.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

value에 대한 문화권별 서식 정보를 제공하는 개체입니다.An object that provides culture-specific formatting information about value.

반환

value 매개 변수에 지정된 숫자에 해당하는 값입니다.A value that is equivalent to the number specified in the value parameter.

예외

styleNumberStyles 값이 아닙니다.style is not a NumberStyles value.

또는-or- style에는 AllowHexSpecifier 또는 HexNumber 플래그가 다른 값과 함께 포함됩니다.style includes the AllowHexSpecifier or HexNumber flag along with another value.

valuestyle에 의해 지정된 입력 패턴에 맞지 않습니다.value does not comply with the input pattern specified by style.

예제

다음 예에서는 몇 번 호출 하는 Parse(String, NumberStyles, IFormatProvider) 다양 한 조합에 대 한 값을 사용 하 여 메서드를 styleprovider 매개 변수입니다.The following example makes several calls to the Parse(String, NumberStyles, IFormatProvider) method using various combinations of values for the style and provider parameters.

// Call parse with default values of style and provider
Console.WriteLine(BigInteger.Parse("  -300   ", 
                  NumberStyles.Integer, CultureInfo.CurrentCulture));
// Call parse with default values of style and provider supporting tilde as negative sign
Console.WriteLine(BigInteger.Parse("   ~300  ", 
                                   NumberStyles.Integer, new BigIntegerFormatProvider()));
// Call parse with only AllowLeadingWhite and AllowTrailingWhite
// Exception thrown because of presence of negative sign
try
{
   Console.WriteLine(BigInteger.Parse("    ~300   ", 
                                NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite, 
                                new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}                                   
// Call parse with only AllowHexSpecifier
// Exception thrown because of presence of negative sign
try
{
   Console.WriteLine(BigInteger.Parse("-3af", NumberStyles.AllowHexSpecifier, 
                                      new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}                                 
// Call parse with only NumberStyles.None
// Exception thrown because of presence of white space and sign
try
{
   Console.WriteLine(BigInteger.Parse(" -300 ", NumberStyles.None, 
                                      new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}
// The example displays the followingoutput:
//       -300
//       -300
//       FormatException:
//          The value could not be parsed.
//       FormatException:
//          The value could not be parsed.
//       FormatException:
//          The value could not be parsed.      
' Call parse with default values of style and provider
Console.WriteLine(BigInteger.Parse("  -300   ", _
                  NumberStyles.Integer, CultureInfo.CurrentCulture))
' Call parse with default values of style and provider supporting tilde as negative sign
Console.WriteLine(BigInteger.Parse("   ~300  ", _
                                   NumberStyles.Integer, New BigIntegerFormatProvider()))
' Call parse with only AllowLeadingWhite and AllowTrailingWhite
' Exception thrown because of presence of negative sign
Try
   Console.WriteLIne(BigInteger.Parse("    ~300   ", _
                                      NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try                                   
' Call parse with only AllowHexSpecifier
' Exception thrown because of presence of negative sign
Try
   Console.WriteLIne(BigInteger.Parse("-3af", NumberStyles.AllowHexSpecifier, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try                                 
' Call parse with only NumberStyles.None
' Exception thrown because of presence of white space and sign
Try
   Console.WriteLIne(BigInteger.Parse(" -300 ", NumberStyles.None, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try
' The example displays the following output:
'       -300
'       -300
'       FormatException:
'          The value could not be parsed.
'       FormatException:
'          The value could not be parsed.
'       FormatException:
'          The value could not be parsed.            

에 대 한 개별 호출 수를 Parse(String, NumberStyles, IFormatProvider) 메서드는 다음의 인스턴스를 전달 BigIntegerFormatProvider 음수 부호와 물결표 (~)를 정의 하는 클래스입니다.A number of the individual calls to the Parse(String, NumberStyles, IFormatProvider) method pass an instance of the following BigIntegerFormatProvider class, which defines a tilde (~) as the negative sign.

public class BigIntegerFormatProvider : IFormatProvider
{
   public object GetFormat(Type formatType) 
   {
      if (formatType == typeof(NumberFormatInfo)) 
      {
         NumberFormatInfo numberFormat = new NumberFormatInfo();
         numberFormat.NegativeSign = "~";
         return numberFormat;
      }
      else
      {
         return null;
      }      
   }
}
Public Class BigIntegerFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                            Implements IFormatProvider.GetFormat
      If formatType Is GetType(NumberFormatInfo) Then
         Dim numberFormat As New NumberFormatInfo
         numberFormat.NegativeSign = "~"
         Return numberFormat
      Else
         Return Nothing
      End If      
   End Function
End Class

설명

합니다 style 매개 변수 (예: 공백, 양수 또는 음수 기호, 그룹 구분 기호 또는 소수점 기호)에 사용할 수 있는 스타일 요소를 정의 합니다 value 구문 분석 작업이 성공 하기 위해 매개 변수입니다.The style parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the value parameter for the parse operation to succeed. styles 비트 플래그 조합 이어야 합니다는 NumberStyles 열거형입니다.styles must be a combination of bit flags from the NumberStyles enumeration. 합니다 style 매개 변수 오버 로드 유용할 경우 이러한 메서드를 만듭니다 value 수 시스템 (10 진수 또는 16 진수)을 나타내는 16 진수 값의 문자열 표현이 포함 되어 value 실행된 시간에만 알려진 때나 있습니다 공백 문자를 허용 하지 않도록 하거나 부호 기호를 value입니다.The style parameter makes this method overload useful when value contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by value is known only at run time, or when you want to disallow white space or a sign symbol in value.

값에 따라 style, value 매개 변수는 다음 요소가 포함 될 수 있습니다.Depending on the value of style, the value parameter may include the following elements:

[ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

하는 경우 style 포함 NumberStyles.AllowHexSpecifier, value 매개 변수는 다음 요소가 포함 될 수 있습니다.If style includes NumberStyles.AllowHexSpecifier, the value parameter may include the following elements:

[ws]hexdigits[ws][ws]hexdigits[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 공백의 시작 부분에 나타날 수 있습니다 value 경우 style 포함 합니다 NumberStyles.AllowLeadingWhite 끝에 있고, 나타날 수 있습니다 value 경우 style 포함를 NumberStyles.AllowTrailingWhite 플래그 합니다.White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열의 해당 위치에서 정의 됩니다는 NumberFormatInfo.CurrencyNegativePattern 하 고 NumberFormatInfo.CurrencyPositivePattern 문화권의 속성에 나타난를 provider 매개 변수입니다.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the culture indicated by the provider parameter. 현재 문화권의 통화 기호에 나타날 수 있습니다 value 하는 경우 style 포함 된 NumberStyles.AllowCurrencySymbol 플래그 합니다.The current culture's currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 로그인의 시작 부분에 나타날 수 있습니다 value 경우 style 포함 합니다 NumberStyles.AllowLeadingSign 끝에 있고, 나타날 수 있습니다 value 경우 style 포함를 NumberStyles.AllowTrailingSign 플래그.The sign can appear at the start of value if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingSign flag. 괄호를 사용할 수 있습니다 value 경우 음수 값을 나타내는 데 style 포함 된 NumberStyles.AllowParentheses 플래그입니다.Parentheses can be used in value to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9. 에 대 한 소수 자릿수숫자 0 유효만 합니다.For fractional_digits, only the digit 0 is valid.
,, Culture 별 그룹 구분 기호입니다.A culture-specific group separator symbol. 지정 된 문화권의 그룹 구분 기호 provider 에 나타날 수 있습니다 value 경우 style 포함를 NumberStyles.AllowThousands 플래그 합니다.The group separator symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. 지정 된 문화권의 소수점 기호 provider 에 나타날 수 있습니다 value 하는 경우 style 포함는 NumberStyles.AllowDecimalPoint 플래그입니다.The decimal point symbol of the culture designated by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag. 구문 분석 작업이 성공 하기 위해 소수 자릿수로 숫자 0만 나타날 수 있습니다. 경우 소수 자릿수 다른 숫자를 포함 한 FormatException throw 됩니다.Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, a FormatException is thrown.
EE "E" 또는 "E" 문자 값은 지 수 (과학적 표기법) 표기법으로 표현 됨을 나타내는입니다.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. value 매개 변수는 경우 지 수 표기법으로 숫자를 나타낼 수 style 포함 된 NumberStyles.AllowExponent 플래그.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 16 진수 숫자 0 ~ f 또는 0 ~ 6. 시퀀스A sequence of hexadecimal digits from 0 through f, or 0 through F.

참고

종료 NUL (U + 0000)에 임의 문자를 s 의 값에 관계 없이 구문 분석 작업에서 무시 되는 style 인수입니다.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

숫자만 문자열 (해당 하는 NumberStyles.None 스타일) 항상 성공적으로 구문 분석 합니다.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. 나머지 대부분 NumberStyles 멤버가 있을 수 있지만 입력된 문자열에 나타날 수 필요가 없습니다 요소를 제어할 수 있습니다.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in the input string. 다음 표에서 개별 NumberStyles 멤버에 나타날 수 있는 요소에 영향을 줄 value합니다.The following table indicates how individual NumberStyles members affect the elements that may be present in value.

NumberStyles 값NumberStyles value 숫자 외에도 값에 허용 되는 요소Elements permitted in value in addition to digits
None 합니다 자릿수 요소에만 합니다.The digits element only.
AllowDecimalPoint 소수점 (.) 및 소수 자릿수 요소입니다.The decimal point (.) and fractional-digits elements.
AllowExponent "E" 또는 "E" 문자를 지 수 표기법을 나타냅니다.The "e" or "E" character, which indicates exponential notation. 와 함께 지 수 표기법합니다.along with exponential_digits.
AllowLeadingWhite 합니다 ws 의 시작 부분에 요소 value합니다.The ws element at the start of value.
AllowTrailingWhite 합니다 ws 의 끝에 있는 요소 value합니다.The ws element at the end of value.
AllowLeadingSign 합니다 sign 의 시작 부분에 요소 value합니다.The sign element at the start of value.
AllowTrailingSign 합니다 sign 의 끝에 있는 요소 value합니다.The sign element at the end of value.
AllowParentheses 합니다 기호 형식의 숫자 값을 묶는 괄호는 요소입니다.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element.
AllowCurrencySymbol 통화 ($) 요소입니다.The currency ($) element.
Currency 모든 요소입니다.All elements. 그러나 value 16 진수 또는 지 수 표기법으로 숫자를에서 나타낼 수 없습니다.However, value cannot represent a hexadecimal number or a number in exponential notation.
Float ws 시작 또는 끝에 요소 value, sign 의 시작 부분에 value, 및 소수점 (.).The ws element at the start or end of value, sign at the start of value, and the decimal point (.) symbol. value 매개 변수 지 수 표기법을 사용할 수도 있습니다.The value parameter can also use exponential notation.
Number 합니다 ws, sign, 그룹 구분 기호 (,), 및 소수점 (.) 요소입니다.The ws, sign, group separator (,), and decimal point (.) elements.
Any 모든 요소입니다.All elements. 그러나 value 16 진수 숫자를 나타낼 수 없습니다.However, value cannot represent a hexadecimal number.

중요

사용 하는 경우는 Parse 왕복 문자열 표현 하기 위해의를 BigInteger 의해 출력 된 값을 ToString 메서드를 사용할지를 BigInteger.ToString(String) 의 문자열 표현을 생성 "R" 서식 지정자를 사용 하 여 메서드를 BigInteger 값입니다.If you use the Parse method to round-trip the string representation of a BigInteger value that was output by the ToString method, you should use the BigInteger.ToString(String) method with the "R" format specifier to generate the string representation of the BigInteger value. 이 고, 그렇지의 문자열 표현 합니다 BigInteger 50 사용 하는 경우 원래 값 및 데이터의 최대 유효 자릿수 손실 될 수 있습니다만 유지 합니다 Parse 복원 하는 방법을 BigInteger 값.Otherwise, the string representation of the BigInteger preserves only the 50 most significant digits of the original value, and data may be lost when you use the Parse method to restore the BigInteger value.

다른 달리 NumberStyles 값을 허용 하지만 특정 스타일 요소에 존재 하지 않아도 valueNumberStyles.AllowHexSpecifier 스타일 값 즉 숫자의 개별 문자에서 value 항상로 해석 됩니다 16 진수 문자입니다.Unlike the other NumberStyles values, which allow for but do not require the presence of particular style elements in value, the NumberStyles.AllowHexSpecifier style value means that the individual numeric characters in value are always interpreted as hexadecimal characters. 유효한 16 진수는 0-9, A-f 및 a-f 문자입니다.Valid hexadecimal characters are 0-9, A-F, and a-f. 만 다른 플래그와 결합 될 수 있는 합니다 style 매개 변수에 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite합니다.The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (합니다 NumberStyles 열거형은 복합 숫자 스타일을 포함 HexNumber, 모두 공백 플래그를 포함 하는.)(The NumberStyles enumeration includes a composite number style, HexNumber, that includes both white-space flags.)

참고

하는 경우 value 문자열 표현인 16 진수 숫자의 고 수 없습니다. 뒤에 야 모든 장식 (같은 0x 또는 &h) 16 진수 숫자로 구분 하는 합니다.If value is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. 이렇게 하면 변환이 실패할 수 있습니다.This causes the conversion to fail.

경우 value 16 진수 문자열을 Parse(String, NumberStyles) 보다 크거나 같습니다 value 음수로 처음 두 16 진수 보다 크거나 같은 경우에 2의 보수 표현이 사용 하 여 저장 0x80합니다.If value is a hexadecimal string, the Parse(String, NumberStyles) method interprets value as a negative number stored by using two's complement representation if its first two hexadecimal digits are greater than or equal to 0x80. 메서드는 첫 번째 바이트의 최상위 비트를 해석 하는 즉, value 부호 비트로입니다.In other words, the method interprets the highest-order bit of the first byte in value as the sign bit. 16 진수 문자열에서 첫 번째 숫자가 양수 숫자로 해석 됩니다 있도록 value 0의 값이 있어야 합니다.To make sure that a hexadecimal string is correctly interpreted as a positive number, the first digit in value must have a value of zero. 예를 들어이 메서드는 해석 0x80 음수 값을 해석 하거나 대로 0x080 또는 0x0080 양수 값으로.For example, the method interprets 0x80 as a negative value, but it interprets either 0x080 or 0x0080 as a positive value. 다음 예에서는 양수 및 음수 값을 나타내는 16 진수 문자열 간의 차이점을 보여 줍니다.The following example illustrates the difference between hexadecimal strings that represent negative and positive values.

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                              "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                              "0080", "00E293", "00F9A2FF", "00FFFFFFFF" };
      foreach (string hexString in hexStrings)
      {
         BigInteger number = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
      }         
   }
}
// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.
Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim hexStrings() As String = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                                     "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                                     "0080", "00E293", "00F9A2FF", "00FFFFFFFF" }
      For Each hexString As String In hexStrings
         Dim number As BigInteger = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
      Next         
   End Sub
End Module
' The example displays the following output:
'       Converted 0x80 to -128.
'       Converted 0xE293 to -7533.
'       Converted 0xF9A2FF to -417025.
'       Converted 0xFFFFFFFF to -1.
'       Converted 0x080 to 128.
'       Converted 0x0E293 to 58003.
'       Converted 0x0F9A2FF to 16360191.
'       Converted 0x0FFFFFFFF to 4294967295.
'       Converted 0x0080 to 128.
'       Converted 0x00E293 to 58003.
'       Converted 0x00F9A2FF to 16360191.
'       Converted 0x00FFFFFFFF to 4294967295.

합니다 provider 매개 변수는 IFormatProvider 구현 합니다.The provider parameter is an IFormatProvider implementation. 해당 GetFormat 메서드가 반환 되는 NumberFormatInfo 개체의 형식에 대 한 문화권별 형식 정보를 제공 하는 value합니다.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of value. 일반적으로 provider 다음 중 하나일 수 있습니다.Typically, provider can be any one of the following:

  • CultureInfo 숫자 형식 지정 정보를 제공 하는 문화권을 나타내는 개체입니다.A CultureInfo object that represents the culture that provides numeric formatting information. 해당 GetFormat 메서드가 반환 되는 NumberFormatInfo 숫자 형식 지정 정보를 제공 하는 개체입니다.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information.

  • NumberFormatInfo 서식 지정 정보를 제공 하는 개체입니다.A NumberFormatInfo object that provides formatting information. (해당 구현의 GetFormat 자체를 반환 합니다.)(Its implementation of GetFormat just returns itself.)

  • 구현 하는 사용자 지정 개체 IFormatProvider 사용 하는 GetFormat 인스턴스화하고 반환 하는 메서드는 NumberFormatInfo 서식 지정 정보를 제공 하는 개체입니다.A custom object that implements IFormatProvider and uses the GetFormat method to instantiate and return the NumberFormatInfo object that provides formatting information.

하는 경우 provider 됩니다 nullNumberFormatInfo 개체가 현재 문화권이 사용 됩니다.If provider is null, the NumberFormatInfo object for the current culture is used.

추가 정보

적용 대상