이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

Int64.Parse 메서드 (String, NumberStyles)

 

게시 날짜: 2016년 11월

지정된 스타일로 된 숫자의 문자열 표현을 해당하는 64비트 부호 있는 정수로 변환합니다.

네임스페이스:   System
어셈블리:  mscorlib(mscorlib.dll에 있음)

public static long Parse(
	string s,
	NumberStyles style
)

매개 변수

s
Type: System.String

변환할 숫자가 포함된 문자열입니다.

style
Type: System.Globalization.NumberStyles

NumberStyles에 사용할 수 있는 형식을 나타내는 s 값의 비트 조합입니다. 지정할 일반적인 값은 Integer입니다.

반환 값

Type: System.Int64

s에 지정된 숫자에 해당하는 64비트 부호 있는 정수입니다.

Exception Condition
ArgumentNullException

snull인 경우

ArgumentException

styleNumberStyles 값이 아닙니다.

또는

styleAllowHexSpecifierHexNumber 값의 조합이 아닙니다.

FormatException

sstyle 규격 형식이 아닙니다.

OverflowException

sMinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다.

또는

style은 소수 자릿수를 지원하지만 s에 0이 아닌 소수 자릿수가 포함되어 있습니다.

style 스타일 요소를 정의 하는 매개 변수 (예: 공백, 양수 또는 음수 부호 기호 또는 1000 단위 구분 기호)에 허용 되는 s 구문 분석 작업이 성공 하기 위해 매개 변수입니다. 비트 플래그의 조합 해야는 NumberStyles 열거형입니다. 값에 따라 style, s 매개 변수는 다음과 같은 요소가 포함 될 수 있습니다.

[ws] [$] [로그인] [숫자] 자리 [. 소수 계열 숫자] [e [로그인] 지 수 표기법] [w]

또는 style 포함 AllowHexSpecifier:

[ws] hexdigits [ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다. 다음 표에서 각 요소에 설명 합니다.

요소

설명

ws

선택적 공백입니다. 맨 앞에 공백이 나타날 수 s 경우 style 포함는 NumberStyles.AllowLeadingWhite 의 끝에 나타날 수 있고, s 경우 style 포함는 NumberStyles.AllowTrailingWhite 플래그입니다.

$

문화권별 통화 기호입니다. 문자열에 해당 위치는 NumberFormatInfo.CurrencyNegativePatternNumberFormatInfo.CurrencyPositivePattern 현재 문화권의 속성입니다. 에 현재 문화권의 통화 기호가 나타날 수 s 경우 style 포함는 NumberStyles.AllowCurrencySymbol 플래그입니다.

로그인

선택적 기호입니다. 부호의 시작 부분에 나타날 수 s 경우 style 포함는 NumberStyles.AllowLeadingSign 의 끝에 나타날 수 있고, s 경우 style 포함는 NumberStyles.AllowTrailingSign 플래그입니다. 괄호를 사용할 수 있습니다 s 경우 음수 값을 나타내는 데 style 포함는 NumberStyles.AllowParentheses 플래그입니다.

digits

소수 자릿수

지 수 표기법

0부터 9 까지의 숫자 시퀀스입니다. 에 대 한 소수 자릿수, 숫자 0은 유효한만 합니다.

,

문화권별 1000 단위 구분 기호입니다. 현재 문화권의 1000 단위 구분 기호에 나타날 수 있습니다 s 경우 style 포함는 NumberStyles.AllowThousands 플래그입니다.

입니다.

문화권별 소수점 기호입니다. 에 현재 문화권의 소수점 기호가 나타날 수 s 경우 style 포함는 NumberStyles.AllowDecimalPoint 플래그입니다. 구문 분석 작업이 성공 하기에 대 한 소수 자릿수 숫자 0만 나타날 수 있습니다. 경우 소수 자릿수 다른 모든 숫자를 포함 한 OverflowException 이 throw 됩니다.

e

'E' 또는 'E' 문자 값이 지 수 표기법으로 표현 됨을 나타냅니다. s 매개 변수는 경우 지 수 표기법으로 숫자를 나타낼 수 style 포함는 NumberStyles.AllowExponent 플래그입니다.

hexdigits

시퀀스의 16 진수 0 ~ f 또는 0-6.

숫자만 있는 문자열 (해당 하는 NumberStyles.None 스타일)의 범위에 있으면 항상 성공적으로 구문 분석는 Int64 유형입니다. 나머지 NumberStyles 멤버 수 있지만 입력된 문자열에 있이 필요가 없습니다 있는 요소를 제어 합니다. 다음 표에서 개별 NumberStyles 멤버에 있을 수 있는 요소에 영향을 s합니다.

NumberStyles 값

숫자 외에도 s에 허용 되는 요소

None

자릿수 요소만 합니다.

AllowDecimalPoint

소수점 ( . ) 및 소수 자릿수 요소입니다.

AllowExponent

s 매개 변수로 지 수 표기법을 사용할 수도 있습니다. 경우 s 결과 숫자 값, 지 수 표기법으로 숫자를 나타내는 0이 아닌 소수 자릿수를 포함할 수 없습니다.

AllowLeadingWhite

ws 의 시작 부분에 요소 s합니다.

AllowTrailingWhite

ws 의 끝에 요소 s합니다.

AllowLeadingSign

기호 의 시작 부분에 요소 s합니다.

AllowTrailingSign

기호 의 끝에 요소 s합니다.

AllowParentheses

기호 괄호 안에 숫자 값이 들어 형식 요소입니다.

AllowThousands

1000 단위 구분 기호 ( , ) 요소입니다.

AllowCurrencySymbol

$ 요소입니다.

Currency

모두. s 매개 변수는 16 진수 또는 지 수 표기법으로 숫자를에서 나타낼 수 없습니다.

Float

ws 시작 또는 끝 요소 s, 기호 맨 앞에 s, 과 소수점 ( . ) 기호입니다. s 매개 변수로 지 수 표기법을 사용할 수도 있습니다.

Number

ws, 기호, 1000 단위 구분 기호 ( , ), 소수점 및 ( . ) 요소입니다.

Any

모든 스타일을 제외 하 고 s 16 자 숫자를 나타낼 수 없습니다.

하는 경우는 NumberStyles.AllowHexSpecifier 플래그가 사용 됩니다. s 접두사 없이 16 진수 값 이어야 합니다. 예를 들어 "C9AF3" 성공적으로 구문 분석 되지만 "0xC9AF3" 하지 않습니다. 만 다른 플래그와 결합 될 수 있는 s 매개 변수는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite합니다. (의 NumberStyles 열거형에는 복합 숫자 스타일 포함 됩니다. NumberStyles.HexNumber, 공백 플래그가 모두 포함 된.)

s 매개 변수에서 서식 지정 정보를 사용 하 여 구문 분석 되는 NumberFormatInfo 현재 시스템 문화권에 대 한 초기화 된 개체입니다. 서식 지정 정보를 가져올 구문 분석 작업이 사용 되는 문화권을 지정 하려면 호출의 Int64.Parse(String, NumberStyles, IFormatProvider) 오버 로드 합니다.

다음 예제에서는 Int64.Parse(String, NumberStyles) 메서드를 여러의 문자열 표현을 구문 분석 Int64 값입니다. 이 예제에 대 한 현재 문화권이 EN-US입니다.

using System;
using System.Globalization;

public class ParseInt32
{
   public static void Main()
   {
      Convert("104.0", NumberStyles.AllowDecimalPoint);
      Convert("104.9", NumberStyles.AllowDecimalPoint);
      Convert (" 106034", NumberStyles.None);
      Convert(" $17,198,064.42", NumberStyles.AllowCurrencySymbol |
                                 NumberStyles.Number);
      Convert(" $17,198,064.00", NumberStyles.AllowCurrencySymbol |
                                 NumberStyles.Number);
      Convert("103E06", NumberStyles.AllowExponent);
      Convert("1200E-02", NumberStyles.AllowExponent);
      Convert("1200E-03", NumberStyles.AllowExponent);
      Convert("-1,345,791", NumberStyles.AllowThousands);
      Convert("(1,345,791)", NumberStyles.AllowThousands |
                             NumberStyles.AllowParentheses);
      Convert("FFCA00A0", NumberStyles.HexNumber);                       
      Convert("0xFFCA00A0", NumberStyles.HexNumber);                       
   }

   private static void Convert(string value, NumberStyles style)
   {
      try
      {
         long number = Int64.Parse(value, style);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to convert '{0}'.", value);
      }
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range of the Int64 type.", value);   
      }
   }
}
// The example displays the following output to the console:
//       Converted '104.0' to 104.
//       '104.9' is out of range of the Int64 type.
//       Unable to convert ' 106034'.
//       ' $17,198,064.42' is out of range of the Int64 type.
//       Converted ' $17,198,064.00' to 17198064.
//       Converted '103E06' to 103000000.
//       Converted '1200E-02' to 12.
//       '1200E-03' is out of range of the Int64 type.
//       Unable to convert '-1,345,791'.
//       Converted '(1,345,791)' to -1345791.
//       Converted 'FFCA00A0' to 4291428512.
//       Unable to convert '0xFFCA00A0'.

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
1.1 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능
맨 위로 이동
표시: