BigInteger.TryParse 메서드

정의

숫자의 문자열 표현을 해당 BigInteger로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

오버로드

TryParse(ReadOnlySpan<Char>, BigInteger)

지정된 읽기 전용 문자 범위에 포함된 숫자의 표현을 해당 BigInteger로 변환해 보고, 변환에 성공했는지를 나타내는 값을 변환합니다.Tries to convert the representation of a number contained in the specified read-only character span, to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, BigInteger)

숫자의 문자열 표현을 해당 BigInteger로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, BigInteger)

숫자의 문자열 표현을 해당 BigInteger로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, NumberStyles, IFormatProvider, BigInteger)

지정된 문화권별 형식과 지정된 스타일을 사용한 숫자의 문자열 표현을 해당 BigInteger로 변환해 보고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number in a specified style and culture-specific format to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, BigInteger)

지정된 읽기 전용 문자 범위에 포함된 숫자의 표현을 해당 BigInteger로 변환해 보고, 변환에 성공했는지를 나타내는 값을 변환합니다.Tries to convert the representation of a number contained in the specified read-only character span, to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParse(ReadOnlySpan<char> value, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (ReadOnlySpan<char> value, out System.Numerics.BigInteger result);
static member TryParse : ReadOnlySpan<char> * BigInteger -> bool
Public Shared Function TryParse (value As ReadOnlySpan(Of Char), ByRef result As BigInteger) As Boolean

매개 변수

value
ReadOnlySpan<Char>

읽기 전용 문자 범위로 나타낸 숫자 표현입니다.The representation of a number as a read-only span of characters.

result
BigInteger

이 메서드가 반환되면 value에 포함된 숫자 또는 변환에 실패한 경우 0에 해당하는 BigInteger를 포함합니다.When this method returns, contains the BigInteger equivalent to the number that is contained in value, or zero (0) if the conversion fails. value 매개 변수가 빈 문자 범위이거나 올바른 서식이 아니면 변환에 실패합니다.The conversion fails if the value parameter is an empty character span or is not of the correct format. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.This parameter is passed uninitialized.

반환

true가 성공적으로 변환되었으면 value이고, 그렇지 않으면 false입니다.true if value was converted successfully; otherwise, false.

추가 정보

TryParse(String, BigInteger)

숫자의 문자열 표현을 해당 BigInteger로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParse(System::String ^ value, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (string value, out System.Numerics.BigInteger result);
static member TryParse : string * BigInteger -> bool
Public Shared Function TryParse (value As String, ByRef result As BigInteger) As Boolean

매개 변수

value
String

숫자의 문자열 표현입니다.The string representation of a number.

result
BigInteger

이 메서드가 반환되면 value에 포함된 숫자 또는 변환에 실패한 경우 0에 해당하는 BigInteger를 포함합니다.When this method returns, contains the BigInteger equivalent to the number that is contained in value, or zero (0) if the conversion fails. value 매개 변수가 null이거나 올바른 서식이 아니면 변환에 실패합니다.The conversion fails if the value parameter is null or is not of the correct format. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.This parameter is passed uninitialized.

반환

true가 성공적으로 변환되었으면 value이고, 그렇지 않으면 false입니다.true if value was converted successfully; otherwise, false.

예외

valuenull인 경우value is null.

예제

다음 예제에서는 TryParse(String, BigInteger) 메서드를 사용 하 여 두 개의 BigInteger 개체를 인스턴스화합니다.The following example uses the TryParse(String, BigInteger) method to instantiate two BigInteger objects. 변환이 성공 하면 각 개체를 다른 숫자에 곱한 다음 Compare 메서드를 호출 하 여 두 개체 간의 관계를 확인 합니다.If the conversions succeed, it multiplies each object by another number and then calls the Compare method to determine the relationship between the two objects.

BigInteger number1, number2;
bool succeeded1 = BigInteger.TryParse("-12347534159895123", out number1);
bool succeeded2 = BigInteger.TryParse("987654321357159852", out number2);
if (succeeded1 && succeeded2)
{
   number1 *= 3;
   number2 *= 2;
   switch (BigInteger.Compare(number1, number2))
   {
      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;
   }      
}
else
{
   if (! succeeded1) 
      Console.WriteLine("Unable to initialize the first BigInteger value.");

   if (! succeeded2)
      Console.WriteLine("Unable to initialize the second BigInteger value.");
}
// The example displays the following output:
//      1975308642714319704 is greater than -37042602479685369.
Dim number1 As BigInteger = BigInteger.Zero
Dim number2 As BigInteger = BigInteger.Zero
Dim succeeded1 As Boolean = BigInteger.TryParse("-12347534159895123", number1)
Dim succeeded2 As Boolean = BigInteger.TryParse("987654321357159852", number2)
If succeeded1 AndAlso succeeded2
   number1 *= 3
   number2 *= 2
   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      
Else
   If Not succeeded1 Then 
      Console.WriteLine("Unable to initialize the first BigInteger value.")
   End If
   If Not succeeded2 Then
      Console.WriteLine("Unable to initialize the second BigInteger value.")
   
   End If
End If
' The example displays the following output:
'      1975308642714319704 is greater than -37042602479685369.

설명

TryParse(String, BigInteger) 메서드는 변환이 실패할 경우 예외를 throw 하지 않는다는 점을 제외 하 고는 Parse(String) 메서드와 비슷합니다.The TryParse(String, BigInteger) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. 이 메서드를 사용 하면 value 유효 하지 않으며 성공적으로 구문 분석할 수 없는 경우 FormatException를 테스트 하기 위해 예외 처리를 사용할 필요가 없습니다.This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be successfully parsed.

value 매개 변수는 다음 형식으로 된 10 진수의 문자열 표현 이어야 합니다.The value parameter should be the string representation of a decimal number in the following form:

[ws] [sign] 숫자[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 사이의 10 진수 시퀀스입니다.A sequence of decimal digits ranging from 0 to 9.

참고

value 매개 변수에 의해 지정 된 문자열은 그룹 구분 기호 또는 소수 구분 기호를 포함할 수 없으며 소수 부분을 포함할 수 없습니다.The string specified by the value parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

value 매개 변수는 NumberStyles.Integer 스타일을 사용 하 여 해석 됩니다.The value parameter is interpreted by using the NumberStyles.Integer style. 10 진수 외에도 선행 공백과 후행 공백만 사용할 수 있습니다.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. value에 나타날 수 있는 문화권별 서식 지정 정보를 사용 하 여 스타일 요소를 명시적으로 정의 하려면 TryParse(String, NumberStyles, IFormatProvider, BigInteger) 메서드를 호출 합니다.To explicitly define the style elements with the culture-specific formatting information that can be present in value, call the TryParse(String, NumberStyles, IFormatProvider, BigInteger) method.

value 매개 변수는 현재 문화권에 대 한 NumberFormatInfo 개체의 서식 지정 정보를 사용 하 여 구문 분석 됩니다.The value parameter is parsed by using the formatting information in a NumberFormatInfo object for the current culture. 자세한 내용은 NumberFormatInfo.CurrentInfo을 참조하세요.For more information, see NumberFormatInfo.CurrentInfo.

이 오버 로드는 value 매개 변수의 모든 숫자를 10 진수 숫자로 해석 합니다.This overload interprets all digits in the value parameter as decimal digits. 16 진수의 문자열 표현을 구문 분석 하려면 TryParse(String, NumberStyles, IFormatProvider, BigInteger) 오버 로드를 대신 호출 합니다.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, BigInteger) overload instead.

추가 정보

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, BigInteger)

숫자의 문자열 표현을 해당 BigInteger로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParse(ReadOnlySpan<char> value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style, IFormatProvider provider, out System.Numerics.BigInteger result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (value As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As BigInteger) As Boolean

매개 변수

value
ReadOnlySpan<Char>

읽기 전용 문자 범위로 나타낸 숫자 표현입니다.The representation of a number as a read-only span of characters.

style
NumberStyles

value에 나타날 수 있는 스타일 요소를 나타내는 열거형 값의 비트 조합입니다.A bitwise combination of enumeration values that indicates the style elements that can be present in value. 지정할 일반적인 값은 Integer입니다.A typical value to specify is Integer.

provider
IFormatProvider

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

result
BigInteger

이 메서드가 반환되면 value에 포함된 숫자 또는 변환에 실패한 경우 BigInteger에 해당하는 Zero를 포함합니다.When this method returns, contains the BigInteger equivalent to the number that is contained in value, or Zero if the conversion failed. value 매개 변수가 빈 문자 범위이거나 style 규격의 서식이 아니면 변환에 실패합니다.The conversion fails if the value parameter is an empty character span or is not in a format that is compliant with style. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.This parameter is passed uninitialized.

반환

true가 성공적으로 변환되었으면 value이고, 그렇지 않으면 false입니다.true if value was converted successfully; otherwise, false.

예외

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

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

설명

이 오버 로드는 변환이 실패할 경우 예외를 throw 하지 않는다는 점을 제외 하 고는 Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) 메서드와 비슷합니다.This overload is like the Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. 이 메서드를 사용 하면 value 잘못 되어 성공적으로 구문 분석할 수 없는 경우 FormatException를 테스트 하기 위해 예외 처리를 사용할 필요가 없습니다.This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be parsed successfully.

style 매개 변수는 구문 분석 작업이 성공 하기 위해 value 매개 변수에 허용 되는 스타일 요소 (예: 공백 또는 긍정 또는 음수 기호)를 정의 합니다.The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the value parameter for the parse operation to succeed. NumberStyles 열거형의 비트 플래그 조합 이어야 합니다.It must be a combination of bit flags from the NumberStyles enumeration. style값에 따라 value 매개 변수에는 다음 요소가 포함 될 수 있습니다.Depending on the value of style, the value parameter may include the following elements:

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

style 매개 변수에 AllowHexSpecifier포함 된 경우 value 매개 변수에 다음 요소가 포함 될 수 있습니다.If the style parameter includes 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. 공백은 style NumberStyles.AllowLeadingWhite 플래그를 포함 하거나 style 플래그가 포함 된 경우 value 끝에 value 표시 될 수 있습니다 NumberStyles.AllowTrailingWhite.White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ 문화권별 통화 기호입니다.A culture-specific currency symbol. value에서 해당 위치는 provider 매개 변수의 GetFormat 메서드에서 반환 되는 NumberFormatInfo 개체의 CurrencyPositivePattern 속성으로 정의 됩니다.Its position in value is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. style NumberStyles.AllowCurrencySymbol 플래그가 포함 된 경우 통화 기호가 value 나타날 수 있습니다.The currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 선택적 기호입니다.An optional sign. 기호는 styleNumberStyles.AllowLeadingSign 플래그가 포함 된 경우 value의 시작 부분에 나타날 수 있으며 style 플래그가 NumberStyles.AllowTrailingSign에 포함 된 경우 value의 끝에 나타날 수 있습니다.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 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.
,, 문화권별 그룹 구분 기호입니다.A culture-specific group separator. provider로 지정 된 문화권의 그룹 구분 기호는 styleNumberStyles.AllowThousands 플래그가 포함 된 경우 value에 표시 될 수 있습니다.The group separator of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. 문화권별 소수점 기호입니다.A culture-specific decimal point symbol. provider로 지정 된 문화권의 소수점 기호는 styleNumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 value에 나타날 수 있습니다.The decimal point symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 0 번 이상 발생 하는 숫자입니다.One or more occurrences of the digit 0. 소수 자릿수는 style NumberStyles.AllowDecimalPoint 플래그를 포함 하는 경우에만 value 표시 될 수 있습니다.Fractional digits can appear in value only if style includes the NumberStyles.AllowDecimalPoint flag.
EE "E" 또는 "E" 문자는 값이 지 수 (과학적) 표기법으로 표시 됨을 나타냅니다.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0부터 f 까지의 16 진수 또는 0에서 F 까지의 16 진수 시퀀스입니다.A sequence of hexadecimal digits from 0 through f, or 0 through F.

참고

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

비 복합 NumberStylesNon-composite NumberStyles values 숫자 외에도 값에 허용 되는 요소Elements permitted in value in addition to digits
None 10 진수입니다.Decimal digits only.
AllowDecimalPoint 소수점 (.) 및 fractional_digits 요소입니다.The decimal point (.) and fractional_digits elements. 그러나 fractional_digits 는 하나 이상의 0 자리로 구성 되거나 메서드가 false을 반환 합니다.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Exponential_digits와 함께 지 수 표기법을 나타내는 "e" 또는 "e" 문자The "e" or "E" character, which indicates exponential notation, along with exponential_digits. value 지 수 표기법으로 숫자를 나타내는 경우에는 0이 아닌 소수 부분을 포함할 수 없습니다.If value represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite value시작 부분에 있는 ws 요소입니다.The ws element at the start of value.
AllowTrailingWhite value끝에 있는 ws 요소입니다.The ws element at the end of value.
AllowLeadingSign 숫자앞에 오는 부호 요소입니다.The sign element before digits.
AllowTrailingSign 숫자뒤의 부호 요소입니다.The sign element after digits.
AllowParentheses 괄호 형식의 부호 요소로, 숫자 값을 포함 합니다.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element.
AllowCurrencySymbol Currency ($) 요소입니다.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, group 구분 기호 (,) 및 소수점 (.) 요소입니다.The ws, sign, group separator (,), and decimal point (.) elements.
Any 모든 요소입니다.All elements. 그러나 value은 16 진수를 나타낼 수 없습니다.However, value cannot represent a hexadecimal number.

NumberStyles.AllowHexSpecifier 플래그를 사용 하는 경우 value는 16 진수 값 이어야 합니다.If the NumberStyles.AllowHexSpecifier flag is used, value must be a hexadecimal value. style에 나타날 수 있는 다른 플래그는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. NumberStyles 열거형에는 공백 플래그를 모두 포함 하는 복합 스타일 HexNumber있습니다.(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

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

  • 서식 지정 정보를 제공 하는 문화권을 나타내는 CultureInfo 개체입니다.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 개체입니다.A NumberFormatInfo object that provides numeric formatting information. (GetFormat의 구현은 자신을 반환 하기만 합니다.)(Its implementation of GetFormat just returns itself.)

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

provider null되 면 현재 문화권에 대 한 NumberFormatInfo 개체가 사용 됩니다.If provider is null, the NumberFormatInfo object for the current culture is used.

추가 정보

TryParse(String, NumberStyles, IFormatProvider, BigInteger)

지정된 문화권별 형식과 지정된 스타일을 사용한 숫자의 문자열 표현을 해당 BigInteger로 변환해 보고, 변환에 성공했는지를 나타내는 값을 반환합니다.Tries to convert the string representation of a number in a specified style and culture-specific format to its BigInteger equivalent, and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (string value, System.Globalization.NumberStyles style, IFormatProvider provider, out System.Numerics.BigInteger result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (value As String, style As NumberStyles, provider As IFormatProvider, ByRef result As BigInteger) As Boolean

매개 변수

value
String

숫자의 문자열 표현입니다.The string representation of a number. 이 문자열은 style이 지정하는 스타일을 사용하여 해석됩니다.The string is interpreted using the style specified by style.

style
NumberStyles

value에 나타날 수 있는 스타일 요소를 나타내는 열거형 값의 비트 조합입니다.A bitwise combination of enumeration values that indicates the style elements that can be present in value. 지정할 일반적인 값은 Integer입니다.A typical value to specify is Integer.

provider
IFormatProvider

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

result
BigInteger

이 메서드가 반환되면 value에 포함된 숫자 또는 변환에 실패한 경우 BigInteger에 해당하는 Zero를 포함합니다.When this method returns, contains the BigInteger equivalent to the number that is contained in value, or Zero if the conversion failed. value 매개 변수가 null이거나 style과 호환되지 않는 서식으로 되어 있으면 변환에 실패합니다.The conversion fails if the value parameter is null or is not in a format that is compliant with style. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.This parameter is passed uninitialized.

반환

true 매개 변수가 변환되었으면 value이고, 그렇지 않으면 false입니다.true if the value parameter was converted successfully; otherwise, false.

예외

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

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

예제

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

string numericString;
BigInteger number = BigInteger.Zero;

// Call TryParse with default values of style and provider.
numericString = "  -300   ";
if (BigInteger.TryParse(numericString, NumberStyles.Integer, 
                       null, out number))
   Console.WriteLine("'{0}' was converted to {1}.", 
                     numericString, number);                    
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.", 
                     numericString);

// Call TryParse with the default value of style and 
// a provider supporting the tilde as negative sign.
numericString = "  -300   ";
if (BigInteger.TryParse(numericString, NumberStyles.Integer,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);                             
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with only AllowLeadingWhite and AllowTrailingWhite.
// Method returns false because of presence of negative sign.
numericString = "  -500   ";
if (BigInteger.TryParse(numericString,
                        NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite,
                        new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);                             
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with AllowHexSpecifier and a hex value.
numericString = "F14237FFAAC086455192";
if (BigInteger.TryParse(numericString,
                        NumberStyles.AllowHexSpecifier,
                        null, out number))
   Console.WriteLine("'{0}' was converted to {1} (0x{1:x}).",
                     numericString, number);                             
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with AllowHexSpecifier and a negative hex value.
// Conversion fails because of presence of negative sign.
numericString = "-3af";
if (BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);       
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with only NumberStyles.None.
// Conversion fails because of presence of white space and sign.
numericString = " -300 ";
if (BigInteger.TryParse(numericString, NumberStyles.None,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);         
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);
                                            
// Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
// Conversion fails because the string is formatted for the en-US culture.
numericString = "9,031,425,666,123,546.00";
if (BigInteger.TryParse(numericString, NumberStyles.Any,
                       new CultureInfo("fr-FR"), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);                     
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
// Conversion succeeds because the string is properly formatted 
// For the fr-FR culture.
numericString = "9 031 425 666 123 546,00";
if (BigInteger.TryParse(numericString, NumberStyles.Any,
                       new CultureInfo("fr-FR"), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);                 
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);
// The example displays the following output:
//    '  -300   ' was converted to -300.
//    Conversion of '  -300   ' to a BigInteger failed.
//    Conversion of '  -500   ' to a BigInteger failed.
//    'F14237FFAAC086455192' was converted to -69613977002644837412462 (0xf14237ffaac086455192).
//    Conversion of '-3af' to a BigInteger failed.
//    Conversion of ' -300 ' to a BigInteger failed.
//    Conversion of '9,031,425,666,123,546.00' to a BigInteger failed.
//    '9 031 425 666 123 546,00' was converted to 9031425666123546.      
Dim numericString As String
Dim number As BigInteger = BigInteger.Zero

' Call TryParse with default values of style and provider.
numericString = "  -300   "
If BigInteger.TryParse(numericString, NumberStyles.Integer,
                       Nothing, number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with the default value of style and 
' a provider supporting the tilde as negative sign.
numericString = "  -300   "
If BigInteger.TryParse(numericString, NumberStyles.Integer,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with only AllowLeadingWhite and AllowTrailingWhite.
' Method returns false because of presence of negative sign.
numericString = "  -500   "
If BigInteger.TryParse(numericString,
                    NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite,
                    New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with AllowHexSpecifier and a hex value.
numericString = "F14237FFAAC086455192"
If BigInteger.TryParse(numericString,
                    NumberStyles.AllowHexSpecifier,
                    Nothing, number) Then
   Console.WriteLine("'{0}' was converted to {1} (0x{1:x}).",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with AllowHexSpecifier and a negative hex value.
' Conversion fails because of presence of negative sign.
numericString = "-3af"
If BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with only NumberStyles.None.
' Conversion fails because of presence of white space and sign.
numericString = " -300 "
If BigInteger.TryParse(numericString, NumberStyles.None,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If 
                                            
' Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
' Conversion fails because the string is formatted for the en-US culture.
numericString = "9,031,425,666,123,546.00"
If BigInteger.TryParse(numericString, NumberStyles.Any,
                       New CultureInfo("fr-FR"), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If

' Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
' Conversion succeeds because the string is properly formatted 
' For the fr-FR culture.
numericString = "9 031 425 666 123 546,00"
If BigInteger.TryParse(numericString, NumberStyles.Any,
                       New CultureInfo("fr-FR"), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If
' The example displays the following output:
'    '  -300   ' was converted to -300.
'    Conversion of '  -300   ' to a BigInteger failed.
'    Conversion of '  -500   ' to a BigInteger failed.
'    'F14237FFAAC086455192' was converted to -69613977002644837412462 (0xf14237ffaac086455192).
'    Conversion of '-3af' to a BigInteger failed.
'    Conversion of ' -300 ' to a BigInteger failed.
'    Conversion of '9,031,425,666,123,546.00' to a BigInteger failed.
'    '9 031 425 666 123 546,00' was converted to 9031425666123546.      

TryParse(String, NumberStyles, IFormatProvider, BigInteger) 메서드에 대 한 개별 호출 수는 물결표 (~)를 음수 기호로 정의 하는 다음 BigIntegerFormatProvider 클래스의 인스턴스를 전달 합니다.A number of the individual calls to the TryParse(String, NumberStyles, IFormatProvider, BigInteger) 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

설명

TryParse(String, NumberStyles, IFormatProvider, BigInteger) 메서드는 변환이 실패할 경우 예외를 throw 하지 않는다는 점을 제외 하 고는 Parse(String, NumberStyles, IFormatProvider) 메서드와 비슷합니다.The TryParse(String, NumberStyles, IFormatProvider, BigInteger) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. 이 메서드를 사용 하면 value 잘못 되어 성공적으로 구문 분석할 수 없는 경우 FormatException를 테스트 하기 위해 예외 처리를 사용할 필요가 없습니다.This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be parsed successfully.

style 매개 변수는 구문 분석 작업이 성공 하기 위해 value 매개 변수에 허용 되는 스타일 요소 (예: 공백 또는 긍정 또는 음수 기호)를 정의 합니다.The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the value parameter for the parse operation to succeed. NumberStyles 열거형의 비트 플래그 조합 이어야 합니다.It must be a combination of bit flags from the NumberStyles enumeration. style값에 따라 value 매개 변수에는 다음 요소가 포함 될 수 있습니다.Depending on the value of style, the value parameter may include the following elements:

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

style 매개 변수에 AllowHexSpecifier포함 된 경우 value 매개 변수에 다음 요소가 포함 될 수 있습니다.If the style parameter includes 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. 공백은 style NumberStyles.AllowLeadingWhite 플래그를 포함 하거나 style 플래그가 포함 된 경우 value 끝에 value 표시 될 수 있습니다NumberStyles.AllowTrailingWhite.White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ 문화권별 통화 기호입니다.A culture-specific currency symbol. 문자열에서의 해당 위치는 provider 매개 변수의 GetFormat 메서드에서 반환 되는 NumberFormatInfo 개체의 CurrencyPositivePattern 속성에 의해 정의 됩니다.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. style NumberStyles.AllowCurrencySymbol 플래그가 포함 된 경우 통화 기호가 value 나타날 수 있습니다.The currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 선택적 기호입니다.An optional sign. 기호는 styleNumberStyles.AllowLeadingSign 플래그가 포함 된 경우 value의 시작 부분에 나타날 수 있으며 style 플래그가 NumberStyles.AllowTrailingSign에 포함 된 경우 value의 끝에 나타날 수 있습니다.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 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.
,, 문화권별 그룹 구분 기호입니다.A culture-specific group separator. provider로 지정 된 문화권의 그룹 구분 기호는 styleNumberStyles.AllowThousands 플래그가 포함 된 경우 value에 표시 될 수 있습니다.The group separator of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. 문화권별 소수점 기호입니다.A culture-specific decimal point symbol. provider로 지정 된 문화권의 소수점 기호는 styleNumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 value에 나타날 수 있습니다.The decimal point symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 0 번 이상 발생 하는 숫자입니다.One or more occurrences of the digit 0. 소수 자릿수는 style NumberStyles.AllowDecimalPoint 플래그를 포함 하는 경우에만 value 표시 될 수 있습니다.Fractional digits can appear in value only if style includes the NumberStyles.AllowDecimalPoint flag.
EE "E" 또는 "E" 문자는 값이 지 수 (과학적) 표기법으로 표시 됨을 나타냅니다.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0부터 f 까지의 16 진수 또는 0에서 F 까지의 16 진수 시퀀스입니다.A sequence of hexadecimal digits from 0 through f, or 0 through F.

참고

s의 모든 종료 NUL (U + 0000) 문자는 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 플래그에 해당 하는 10 진수 숫자만 있는 문자열은 항상 성공적으로 구문 분석 합니다.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. 나머지 NumberStyles 멤버 대부분은 표시 될 수 있지만 반드시 필요한 것은 아니지만이 입력 문자열에 있는 요소를 제어 합니다.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. 다음 표에서는 개별 NumberStyles 멤버가 value에 있을 수 있는 요소에 미치는 영향을 보여 줍니다.The following table indicates how individual NumberStyles members affect the elements that may be present in value.

비 복합 NumberStylesNon-composite NumberStyles values 숫자 외에도 값에 허용 되는 요소Elements permitted in value in addition to digits
None 10 진수입니다.Decimal digits only.
AllowDecimalPoint 소수점 (.) 및 fractional_digits 요소입니다.The decimal point (.) and fractional_digits elements. 그러나 fractional_digits 는 하나 이상의 0 자리로 구성 되거나 메서드가 false을 반환 합니다.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Exponential_digits와 함께 지 수 표기법을 나타내는 "e" 또는 "e" 문자The "e" or "E" character, which indicates exponential notation, along with exponential_digits. value 지 수 표기법으로 숫자를 나타내는 경우에는 0이 아닌 소수 부분을 포함할 수 없습니다.If value represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite value시작 부분에 있는 ws 요소입니다.The ws element at the start of value.
AllowTrailingWhite value끝에 있는 ws 요소입니다.The ws element at the end of value.
AllowLeadingSign 숫자앞에 오는 부호 요소입니다.The sign element before digits.
AllowTrailingSign 숫자뒤의 부호 요소입니다.The sign element after digits.
AllowParentheses 괄호 형식의 부호 요소로, 숫자 값을 포함 합니다.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element.
AllowCurrencySymbol Currency ($) 요소입니다.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, group 구분 기호 (,) 및 소수점 (.) 요소입니다.The ws, sign, group separator (,), and decimal point (.) elements.
Any 모든 요소입니다.All elements. 그러나 value은 16 진수를 나타낼 수 없습니다.However, value cannot represent a hexadecimal number.

중요

TryParse 메서드를 사용 하 여 ToString 메서드에서 출력 된 BigInteger 값의 문자열 표현을 라운드트립 하는 경우 "R" 형식 지정자와 함께 BigInteger.ToString(String) 메서드를 사용 하 여 BigInteger 값의 문자열 표현을 생성 해야 합니다.If you use the TryParse 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의 유효 숫자만 유지 하 고 TryParse 메서드를 사용 하 여 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 TryParse method to restore the BigInteger value.

NumberStyles.AllowHexSpecifier 플래그를 사용 하는 경우 value는 16 진수 값 이어야 합니다.If the NumberStyles.AllowHexSpecifier flag is used, value must be a hexadecimal value. style에 나타날 수 있는 다른 플래그는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. NumberStyles 열거형에는 공백 플래그를 모두 포함 하는 복합 스타일 HexNumber있습니다.(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

참고

value 16 진수의 문자열 표현인 경우 16 진수를 구분 하는 데코레이션 (예: 0x 또는 &h) 앞에 올 수 없습니다.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 진수 문자열이 면 TryParse(String, NumberStyles, IFormatProvider, BigInteger) 메서드는 처음 두 16 진수가 0x80보다 크거나 같은 경우 2의 보수 표현을 사용 하 여 저장 된 음수로 value 해석 합니다.If value is a hexadecimal string, the TryParse(String, NumberStyles, IFormatProvider, BigInteger) 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" };
      BigInteger number = BigInteger.Zero;
                              
      foreach (string hexString in hexStrings)
      {
         if (BigInteger.TryParse(hexString, NumberStyles.AllowHexSpecifier,
                                 null, out number))
            Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
         else
            Console.WriteLine("Cannot convert '{0}' to a BigInteger.", hexString);
      }
   }
}
// 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" }
      Dim number As BigInteger = BigInteger.Zero
      
      For Each hexString As String In hexStrings
         If BigInteger.TryParse(hexString, NumberStyles.AllowHexSpecifier, 
                                Nothing, number) Then
            Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
         Else
            Console.WriteLine("Cannot convert '{0}' to a BigInteger.", hexString)
         End If
      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 메서드는 value형식에 대 한 문화권별 정보를 제공 하는 NumberFormatInfo 개체를 반환 합니다.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of value. provider 매개 변수는 다음 중 하나일 수 있습니다.The provider parameter can be any one of the following:

  • 서식 지정 정보를 제공 하는 문화권을 나타내는 CultureInfo 개체입니다.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 개체입니다.A NumberFormatInfo object that provides numeric formatting information. (GetFormat의 구현은 자신을 반환 하기만 합니다.)(Its implementation of GetFormat just returns itself.)

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

provider null되 면 현재 문화권에 대 한 NumberFormatInfo 개체가 사용 됩니다.If provider is null, the NumberFormatInfo object for the current culture is used.

추가 정보

적용 대상