SByte.Parse 메서드

정의

숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number to its 8-bit signed integer equivalent.

오버로드

Parse(String, NumberStyles, IFormatProvider)

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

지정된 스타일 및 문화권별 형식으로 된 숫자의 범위 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the span representation of a number that is in a specified style and culture-specific format to its 8-bit signed equivalent.

Parse(String, NumberStyles)

지정된 스타일로 된 숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number in a specified style to its 8-bit signed integer equivalent.

Parse(String)

숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number to its 8-bit signed integer equivalent.

Parse(String, IFormatProvider)

지정된 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number in a specified culture-specific format to its 8-bit signed integer equivalent.

Parse(String, NumberStyles, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

CLS 대체 규격
System.Int16.Parse(String, NumberStyles, IFormatProvider)

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

public:
 static System::SByte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static sbyte Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> sbyte
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As SByte

매개 변수

s
String

변환할 숫자가 포함된 문자열입니다.A string that contains the number to convert. 이 문자열은 style에서 지정된 스타일을 사용하여 해석됩니다.The string is interpreted by using the style specified by style.

style
NumberStyles

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

provider
IFormatProvider

s에 대한 문화권별 형식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information about s. providernull이면 현재 스레드 문화권이 사용됩니다.If provider is null, the thread current culture is used.

반환

s 매개 변수에 지정된 숫자에 해당하는 8비트 부호 있는 바이트 값입니다.An 8-bit signed byte value that is equivalent to the number specified in the s parameter.

특성

예외

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

-또는--or- styleAllowHexSpecifierHexNumber의 조합이 아닙니다.style is not a combination of AllowHexSpecifier and HexNumber.

snull인 경우s is null.

sstyle 규격 형식이 아닙니다.s is not in a format that is compliant with style.

sMinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다.s represents a number that is less than MinValue or greater than MaxValue.

-또는--or- s에 0이 아닌 소수 자릿수가 포함되어 있습니다.s includes non-zero, fractional digits.

예제

다음 예제에서는 Parse(String, NumberStyles, IFormatProvider) 메서드를 사용 하 여 숫자의 다양 한 문자열 표현을 부호 있는 정수 값으로 변환 하는 방법을 보여 줍니다.The following example illustrates the use of the Parse(String, NumberStyles, IFormatProvider) method to convert various string representations of numbers to signed integer values.

using System;
using System.Globalization;

public class SByteConversion
{
   NumberFormatInfo provider = NumberFormatInfo.CurrentInfo;

   public static void Main()
   {
      string stringValue;
      NumberStyles style;

      stringValue = "   123   ";
      style = NumberStyles.None;     
      CallParseOperation(stringValue, style);
      
      stringValue = "000,000,123";
      style = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallParseOperation(stringValue, style);
      
      stringValue = "-100";
      style = NumberStyles.AllowLeadingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "100-";
      style = NumberStyles.AllowLeadingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "100-";
      style = NumberStyles.AllowTrailingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "$100";
      style = NumberStyles.AllowCurrencySymbol;
      CallParseOperation(stringValue, style);
      
      style = NumberStyles.Integer;
      CallParseOperation(stringValue, style);
      
      style = NumberStyles.AllowDecimalPoint;
      CallParseOperation("100.0", style);
      
      stringValue = "1e02";
      style = NumberStyles.AllowExponent;
      CallParseOperation(stringValue, style);
      
      stringValue = "(100)";
      style = NumberStyles.AllowParentheses;
      CallParseOperation(stringValue, style);
   }
   
   private static void CallParseOperation(string stringValue, 
                                          NumberStyles style)
   {                                          
      sbyte number;
      
      if (stringValue == null)
         Console.WriteLine("Cannot parse a null string...");
         
      try
      {
         number = sbyte.Parse(stringValue, style);
         Console.WriteLine("SByte.Parse('{0}', {1})) = {2}", 
                           stringValue, style, number);   
      }
      catch (FormatException)
      {
         Console.WriteLine("'{0}' and {1} throw a FormatException", 
                           stringValue, style);   
      }      
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is outside the range of a signed byte",
                           stringValue);
      }
   }
}
// The example displays the following information to the console:
//       '   123   ' and None throw a FormatException
//       SByte.Parse('000,000,123', Integer, AllowThousands)) = 123
//       SByte.Parse('-100', AllowLeadingSign)) = -100
//       '100-' and AllowLeadingSign throw a FormatException
//       SByte.Parse('100-', AllowTrailingSign)) = -100
//       SByte.Parse('$100', AllowCurrencySymbol)) = 100
//       '$100' and Integer throw a FormatException
//       SByte.Parse('100.0', AllowDecimalPoint)) = 100
//       SByte.Parse('1e02', AllowExponent)) = 100
//       SByte.Parse('(100)', AllowParentheses)) = -100
Imports System.Globalization

Module modMain
   Public Sub Main()
      Dim byteString As String 
      
      byteString = " 123"
      ParseString(byteString, NumberStyles.None)
      ParseString(byteString, NumberStyles.Integer)
      
      byteString = "3A"
      ParseString(byteString, NumberStyles.AllowHexSpecifier) 
      
      byteString = "21"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.AllowHexSpecifier)
      
      byteString = "-22"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.AllowParentheses)
      
      byteString = "(45)"
      ParseString(byteString, NumberStyles.AllowParentheses)
     
      byteString = "000,000,056"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.Integer Or NumberStyles.AllowThousands)
   End Sub
   
   Private Sub ParseString(value As String, style As NumberStyles)
      Dim number As SByte
      
      If value Is Nothing Then Console.WriteLine("Cannot parse a null string...") 
      
      Try
         number = SByte.Parse(value, style, NumberFormatInfo.CurrentInfo)
         Console.WriteLine("SByte.Parse('{0}', {1}) = {2}", value, style, number)   
      Catch e As FormatException
         Console.WriteLine("'{0}' and {1} throw a FormatException", value, style)   
      Catch e As OverflowException
         Console.WriteLine("'{0}' is outside the range of a signed byte",
                           value)
      End Try     
   End Sub
End Module
' The example displays the following information to the console:
'       ' 123' and None throw a FormatException
'       SByte.Parse(" 123", Integer)) = 123
'       SByte.Parse("3A", AllowHexSpecifier)) = 58
'       SByte.Parse("21", Integer)) = 21
'       SByte.Parse("21", AllowHexSpecifier)) = 33
'       SByte.Parse("-22", Integer)) = -22
'       '-22' and AllowParentheses throw a FormatException
'       SByte.Parse("(45)", AllowParentheses)) = -45
'       '000,000,056' and Integer throw a FormatException
'       SByte.Parse("000,000,056", Integer, AllowThousands)) = 56

설명

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

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

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

style AllowHexSpecifier포함 하는 경우 s 매개 변수에 다음 요소가 포함 될 수 있습니다.If style includes AllowHexSpecifier, the s 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 플래그를 포함 하는 경우 s의 시작 부분에 공백이 표시 될 수 있으며 style 플래그가 NumberStyles.AllowTrailingWhite에 포함 된 경우 s 끝에 나타날 수 있습니다.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열에서의 해당 위치는 현재 문화권의 NumberFormatInfo.CurrencyPositivePattern 속성에 의해 정의 됩니다.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the current culture. style NumberStyles.AllowCurrencySymbol 플래그가 포함 된 경우 현재 문화권의 통화 기호가 s에 표시 될 수 있습니다.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 기호는 style NumberStyles.AllowLeadingSign 플래그가 포함 된 경우 s의 시작 부분에 나타날 수 있으며 style 플래그가 포함 된 경우 s의 끝에 표시 될 수 있습니다.NumberStyles.AllowTrailingSignThe sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear the end of s if style includes the NumberStyles.AllowTrailingSign flag. s에서 괄호를 사용 하 여 style NumberStyles.AllowParentheses 플래그가 포함 된 경우 음수 값을 나타낼 수 있습니다.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. style NumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 현재 문화권의 소수점 기호가 s 나타날 수 있습니다.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits style NumberStyles.AllowExponent 플래그가 포함 된 경우 하나 이상의 숫자 0-9이 고, 그렇지 않은 경우 0 개 이상의 숫자 0이 발생 합니다.One or more occurrences of the digit 0-9 if style includes the NumberStyles.AllowExponent flag, or one or more occurrences of the digit 0 if it does not. 소수 자릿수는 style NumberStyles.AllowDecimalPoint 플래그를 포함 하는 경우에만 s 표시 될 수 있습니다.Fractional digits can appear in s 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 플래그가 포함 된 경우 s 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The s 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 플래그가 포함 된 경우 s 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The s 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.

참고

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 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 this input string. 다음 표에서는 개별 NumberStyles 멤버가 s에 있을 수 있는 요소에 미치는 영향을 보여 줍니다.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

비 복합 NumberStylesNon-composite NumberStyles values 숫자 외에도 s에서 허용 되는 요소Elements permitted in s in addition to digits
NumberStyles.None 소수 자릿수에만 해당 합니다.Decimal digits only.
NumberStyles.AllowDecimalPoint 소수점 (.) 및 fractional_digits 요소입니다.The decimal point (.) and fractional_digits elements. 그러나 style에 NumberStyles.AllowExponent 플래그가 포함 되어 있지 않으면 fractional_digits 0 자리로만 구성 되어야 합니다. 그렇지 않으면 OverflowException throw 됩니다.However, if style does not include the NumberStyles.AllowExponent flag, fractional_digits must consist of only one or more 0 digits; otherwise, an OverflowException is thrown.
NumberStyles.AllowExponent Exponential_digits와 함께 지 수 표기법을 나타내는 "e" 또는 "e" 문자The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite s시작 부분에 있는 ws 요소입니다.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite s끝에 있는 ws 요소입니다.The ws element at the end of s.
NumberStyles.AllowLeadingSign 숫자앞에 긍정 부호를 만듭니다.A positive sign before digits.
NumberStyles.AllowTrailingSign 숫자뒤의 양수 부호입니다.A positive sign after digits.
NumberStyles.AllowParentheses 음수 값을 나타내는 괄호 앞뒤의 숫자 입니다.Parentheses before and after digits to indicate a negative value.
NumberStyles.AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element. 그룹 구분 기호는 s표시 될 수 있지만 하나 이상의 0 자리로 시작 해야 합니다.Although the group separator can appear in s, it must be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol Currency ($) 요소입니다.The currency ($) element.

NumberStyles.AllowHexSpecifier 플래그를 사용 하는 경우 s는 16 진수 값 이어야 합니다.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. 올바른 16 진수 숫자는 0-9, a-f, A-fValid hexadecimal digits are 0-9, a-f, and A-F. 함께 사용할 수 있는 다른 플래그는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. NumberStyles 열거형에는 공백 플래그를 모두 포함 하는 복합 숫자 스타일 NumberStyles.HexNumber포함 되어 있습니다.(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

참고

s 매개 변수가 16 진수의 문자열 표현인 경우 16 진수를 구분 하는 데코레이션 (예: 0x 또는 &h) 뒤에 올 수 없습니다.If the s parameter 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. 이렇게 하면 구문 분석 작업에서 예외를 throw 합니다.This causes the parse operation to throw an exception.

s 16 진수를 나타내는 Parse(String, NumberStyles) 메서드는 바이트의 상위 비트를 부호 비트로 해석 합니다.If s represents a hexadecimal number, the Parse(String, NumberStyles) method interprets the high-order bit of the byte as a sign bit.

provider 매개 변수는 GetFormat 메서드가 s형식에 대 한 문화권별 정보를 제공 하는 NumberFormatInfo 개체를 반환 하는 IFormatProvider 구현입니다.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. provider 매개 변수를 사용 하 여 구문 분석 작업에 사용자 지정 서식 지정 정보를 제공 하는 방법에는 세 가지가 있습니다.There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 서식 지정 정보를 제공 하는 실제 NumberFormatInfo 개체를 전달할 수 있습니다.You can pass the actual NumberFormatInfo object that provides formatting information. GetFormat의 구현은 단순히 자신을 반환 합니다.(Its implementation of GetFormat simply returns itself.)

  • 서식 지정을 사용할 문화권을 지정 하는 CultureInfo 개체를 전달할 수 있습니다.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. 해당 NumberFormat 속성은 서식 지정 정보를 제공 합니다.Its NumberFormat property provides formatting information.

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

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

지정된 스타일 및 문화권별 형식으로 된 숫자의 범위 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the span representation of a number that is in a specified style and culture-specific format to its 8-bit signed equivalent.

[System.CLSCompliant(false)]
public static sbyte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> sbyte
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As SByte

매개 변수

s
ReadOnlySpan<Char>

변환할 숫자를 나타내는 문자를 포함하는 범위입니다.A span containing the characters representing the number to convert. style로 지정된 스타일을 사용하여 이 범위를 해석합니다.The span is interpreted by using the style specified by style.

style
NumberStyles

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

provider
IFormatProvider

s에 대한 문화권별 형식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information about s. providernull이면 현재 스레드 문화권이 사용됩니다.If provider is null, the thread current culture is used.

반환

s 매개 변수에 지정된 숫자에 해당하는 8비트 부호 있는 바이트 값입니다.An 8-bit signed byte value that is equivalent to the number specified in the s parameter.

특성

Parse(String, NumberStyles)

중요

이 API는 CLS 규격이 아닙니다.

CLS 대체 규격
System.Int16.Parse(String)

지정된 스타일로 된 숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number in a specified style to its 8-bit signed integer equivalent.

public:
 static System::SByte Parse(System::String ^ s, System::Globalization::NumberStyles style);
[System.CLSCompliant(false)]
public static sbyte Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> sbyte
Public Shared Function Parse (s As String, style As NumberStyles) As SByte

매개 변수

s
String

변환할 숫자가 포함된 문자열입니다.A string that contains a number to convert. 이 문자열은 style이 지정하는 스타일을 사용하여 해석됩니다.The string is interpreted using the style specified by style.

style
NumberStyles

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

반환

s에 지정된 숫자에 해당하는 8비트 부호 있는 정수입니다.An 8-bit signed integer that is equivalent to the number specified in s.

특성

예외

snull인 경우s is null.

sstyle 규격 형식이 아닙니다.s is not in a format that is compliant with style.

sMinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다.s represents a number less than MinValue or greater than MaxValue.

-또는--or- s에 0이 아닌 소수 자릿수가 포함되어 있습니다.s includes non-zero, fractional digits.

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

-또는--or- styleAllowHexSpecifierHexNumber 값의 조합이 아닙니다.style is not a combination of AllowHexSpecifier and HexNumber values.

예제

다음 예제에서는 Parse(String, NumberStyles) 메서드를 사용 하 여 SByte 값의 문자열 표현을 구문 분석 합니다.The following example parses string representations of SByte values with the Parse(String, NumberStyles) method. 예를 들어 현재 문화권이 EN-US입니다.The current culture for the example is en-US.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberStyles style;
      sbyte number;

      // Parse value with no styles allowed.
      string[] values1 = { " 121 ", "121", "-121" };
      style = NumberStyles.None;
      Console.WriteLine("Styles: {0}", style.ToString());
      foreach (string value in values1)
      {
         try {
            number = SByte.Parse(value, style);
            Console.WriteLine("   Converted '{0}' to {1}.", value, number);
         }   
         catch (FormatException) {
            Console.WriteLine("   Unable to parse '{0}'.", value);
         }
      }
      Console.WriteLine();
            
      // Parse value with trailing sign.
      style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
      string[] values2 = { " 103+", " 103 +", "+103", "(103)", "   +103  " };
      Console.WriteLine("Styles: {0}", style.ToString());
      foreach (string value in values2)
      {
         try {
            number = SByte.Parse(value, style);
            Console.WriteLine("   Converted '{0}' to {1}.", value, number);
         }   
         catch (FormatException) {
            Console.WriteLine("   Unable to parse '{0}'.", value);
         }      
         catch (OverflowException) {
            Console.WriteLine("   '{0}' is out of range of the SByte type.", value);         
         }
      }      
      Console.WriteLine();
   }
}
// The example displays the following output:
//       Styles: None
//          Unable to parse ' 121 '.
//          Converted '121' to 121.
//          Unable to parse '-121'.
//       
//       Styles: Integer, AllowTrailingSign
//          Converted ' 103+' to 103.
//          Converted ' 103 +' to 103.
//          Converted '+103' to 103.
//          Unable to parse '(103)'.
//          Converted '   +103  ' to 103.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim style As NumberStyles
      Dim number As SByte

      ' Parse value with no styles allowed.
      Dim values1() As String = { " 121 ", "121", "-121" }
      style = NumberStyles.None
      Console.WriteLine("Styles: {0}", style.ToString())
      For Each value As String In values1
         Try
            number = SByte.Parse(value, style)
            Console.WriteLine("   Converted '{0}' to {1}.", value, number)
         Catch e As FormatException
            Console.WriteLine("   Unable to parse '{0}'.", value)   
         End Try
      Next
      Console.WriteLine()
            
      ' Parse value with trailing sign.
      style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
      Dim values2() As String = { " 103+", " 103 +", "+103", "(103)", "   +103  " }
      Console.WriteLine("Styles: {0}", style.ToString())
      For Each value As String In values2
         Try
            number = SByte.Parse(value, style)
            Console.WriteLine("   Converted '{0}' to {1}.", value, number)
         Catch e As FormatException
            Console.WriteLine("   Unable to parse '{0}'.", value)   
         Catch e As OverflowException
            Console.WriteLine("   '{0}' is out of range of the SByte type.", value)         
         End Try
      Next      
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       Styles: None
'          Unable to parse ' 121 '.
'          Converted '121' to 121.
'          Unable to parse '-121'.
'       
'       Styles: Integer, AllowTrailingSign
'          Converted ' 103+' to 103.
'          Converted ' 103 +' to 103.
'          Converted '+103' to 103.
'          Unable to parse '(103)'.
'          Converted '   +103  ' to 103.

설명

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

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

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

style NumberStyles.AllowHexSpecifier포함 하는 경우 s 매개 변수에 다음 요소가 포함 될 수 있습니다.If style includes NumberStyles.AllowHexSpecifier, the s 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. style NumberStyles.AllowLeadingWhite 플래그를 포함 하는 경우 s의 시작 부분에 공백이 표시 될 수 있으며, 스타일에 NumberStyles.AllowTrailingWhite 플래그가 포함 된 경우 s의 끝에 표시 될 수 있습니다.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열에서의 해당 위치는 현재 문화권의 NumberFormatInfo.CurrencyPositivePattern 속성에 의해 정의 됩니다.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the current culture. style NumberStyles.AllowCurrencySymbol 플래그가 포함 된 경우 현재 문화권의 통화 기호가 s에 표시 될 수 있습니다.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 기호는 style NumberStyles.AllowLeadingSign 플래그가 포함 된 경우 s 시작 부분에 나타날 수 있으며 style 플래그가 포함 된 NumberStyles.AllowTrailingSign의 경우 s 끝에 표시 될 수 있습니다.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. s에서 괄호를 사용 하 여 style NumberStyles.AllowParentheses 플래그가 포함 된 경우 음수 값을 나타낼 수 있습니다.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. style NumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 현재 문화권의 소수점 기호가 s 나타날 수 있습니다.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits style NumberStyles.AllowExponent 플래그가 포함 된 경우 하나 이상의 숫자 0-9이 고, 그렇지 않은 경우 0 개 이상의 숫자 0이 발생 합니다.One or more occurrences of the digit 0-9 if style includes the NumberStyles.AllowExponent flag, or one or more occurrences of the digit 0 if it does not. 소수 자릿수는 style NumberStyles.AllowDecimalPoint 플래그를 포함 하는 경우에만 s 표시 될 수 있습니다.Fractional digits can appear in s 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 플래그가 포함 된 경우 s 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits 0-9의 숫자를 하나 이상 발견 합니다.One or more occurrences of the digit 0-9. style NumberStyles.AllowExponent 플래그가 포함 된 경우 s 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The s 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.

참고

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 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 멤버가 s에 있을 수 있는 요소에 미치는 영향을 보여 줍니다.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

비 복합 NumberStyles 값Non-composite NumberStyles values 숫자 외에 s 에서 허용 되는 요소Elements permitted in s in addition to digits
NumberStyles.None 소수 자릿수에만 해당 합니다.Decimal digits only.
NumberStyles.AllowDecimalPoint 소수점 (.) 및 fractional_digits 요소입니다.The decimal point (.) and fractional_digits elements. 그러나 styleNumberStyles.AllowExponent 플래그가 포함 되어 있지 않으면 fractional_digits 0 자리로만 구성 되어야 합니다. 그렇지 않으면 OverflowException throw 됩니다.However, if style does not include the NumberStyles.AllowExponent flag, fractional_digits must consist of only one or more 0 digits; otherwise, an OverflowException is thrown.
NumberStyles.AllowExponent Exponential_digits와 함께 지 수 표기법을 나타내는 "e" 또는 "e" 문자The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite s시작 부분에 있는 ws 요소입니다.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite s끝에 있는 ws 요소입니다.The ws element at the end of s.
NumberStyles.AllowLeadingSign 숫자앞에 긍정 부호를 만듭니다.A positive sign before digits.
NumberStyles.AllowTrailingSign 숫자뒤의 양수 부호입니다.A positive sign after digits.
NumberStyles.AllowParentheses 괄호 형식의 부호 요소로, 숫자 값을 포함 합니다.The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element. 그룹 구분 기호는 s표시 될 수 있지만 하나 이상의 0 자리로 시작 해야 합니다.Although the group separator can appear in s, it must be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol Currency ($) 요소입니다.The currency ($) element.

NumberStyles.AllowHexSpecifier 플래그를 사용 하는 경우 s는 16 진수 값 이어야 합니다.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. 올바른 16 진수 숫자는 0-9, a-f, A-fValid hexadecimal digits are 0-9, a-f, and A-F. "0x"와 같은 접두사가 지원 되지 않으며 하면 구문 분석 작업이 실패 합니다.A prefix such as "0x" is not supported and causes the parse operation to fail. style에 포함 될 수 있는 다른 플래그는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be combined included in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. NumberStyles 열거형에는 공백 플래그를 모두 포함 하는 복합 숫자 스타일 NumberStyles.HexNumber포함 되어 있습니다.(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

참고

s 매개 변수가 16 진수의 문자열 표현인 경우 16 진수를 구분 하는 데코레이션 (예: 0x 또는 &h) 뒤에 올 수 없습니다.If the s parameter 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. 이렇게 하면 구문 분석 작업에서 예외를 throw 합니다.This causes the parse operation to throw an exception.

s 16 진수를 나타내는 Parse(String, NumberStyles) 메서드는 바이트의 상위 비트를 부호 비트로 해석 합니다.If s represents a hexadecimal number, the Parse(String, NumberStyles) method interprets the high-order bit of the byte as a sign bit.

s 매개 변수는 현재 시스템 문화권에 대해 초기화 되는 NumberFormatInfo 개체의 서식 지정 정보를 사용 하 여 구문 분석 됩니다.The s 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 use the formatting information of some other culture, call the Parse(String, NumberStyles, IFormatProvider) overload.

추가 정보

Parse(String)

중요

이 API는 CLS 규격이 아닙니다.

CLS 대체 규격
System.Int16.Parse(String)

숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number to its 8-bit signed integer equivalent.

public:
 static System::SByte Parse(System::String ^ s);
[System.CLSCompliant(false)]
public static sbyte Parse (string s);
static member Parse : string -> sbyte
Public Shared Function Parse (s As String) As SByte

매개 변수

s
String

변환할 숫자를 나타내는 문자열입니다.A string that represents a number to convert. 이 문자열은 Integer 스타일을 사용하여 해석됩니다.The string is interpreted using the Integer style.

반환

s 매개 변수에 있는 숫자에 해당하는 8비트 부호 있는 정수입니다.An 8-bit signed integer that is equivalent to the number contained in the s parameter.

특성

예외

snull인 경우s is null.

s가 선택적 부호와 숫자 시퀀스(0~9)로 구성되어 있지 않습니다.s does not consist of an optional sign followed by a sequence of digits (zero through nine).

sMinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다.s represents a number less than MinValue or greater than MaxValue.

예제

다음 예제에서는 Parse 메서드를 사용 하 여 문자열 값을 부호 있는 바이트 값으로 변환 하는 방법을 보여 줍니다.The following example demonstrates how to convert a string value into a signed byte value using the Parse method. 결과 부호 있는 바이트 값을 콘솔에 표시 됩니다.The resulting signed byte value is then displayed to the console.

// Define an array of numeric strings.
string[] values = { "-16", "  -3", "+ 12", " +12 ", "  12  ",
                    "+120", "(103)", "192", "-160" };
                           
// Parse each string and display the result.
foreach (string value in values)
{
   try {
      Console.WriteLine("Converted '{0}' to the SByte value {1}.",
                        value, SByte.Parse(value));
   }
   catch (FormatException) {
      Console.WriteLine("'{0}' cannot be parsed successfully by SByte type.",
                        value);
   }                              
   catch (OverflowException) {
      Console.WriteLine("'{0}' is out of range of the SByte type.",
                        value);
   }                                                                        
}
// The example displays the following output:
//       Converted '-16' to the SByte value -16.
//       Converted '  -3' to the SByte value -3.
//       '+ 12' cannot be parsed successfully by SByte type.
//       Converted ' +12 ' to the SByte value 12.
//       Converted '  12  ' to the SByte value 12.
//       Converted '+120' to the SByte value 120.
//       '(103)' cannot be parsed successfully by SByte type.
//       '192' is out of range of the SByte type.
//       '-160' is out of range of the SByte type.
' Define an array of numeric strings.
Dim values() As String = { "-16", "  -3", "+ 12", " +12 ", "  12  ", _
                           "+120", "(103)", "192", "-160" }
                           
' Parse each string and display the result.
For Each value As String In values
   Try
      Console.WriteLine("Converted '{0}' to the SByte value {1}.", _
                        value, SByte.Parse(value))
   Catch e As FormatException
      Console.WriteLine("'{0}' cannot be parsed successfully by SByte type.", _
                        value)
   Catch e As OverflowException
      Console.WriteLine("'{0}' is out of range of the SByte type.", _
                        value)
   End Try                                                                        
Next        
' The example displays the following output:
'       Converted '-16' to the SByte value -16.
'       Converted '  -3' to the SByte value -3.
'       '+ 12' cannot be parsed successfully by SByte type.
'       Converted ' +12 ' to the SByte value 12.
'       Converted '  12  ' to the SByte value 12.
'       Converted '+120' to the SByte value 120.
'       '(103)' cannot be parsed successfully by SByte type.
'       '192' is out of range of the SByte type.
'       '-160' is out of range of the SByte type.

설명

s 매개 변수에는 다음과 같은 형식이 포함 됩니다.The s parameter contains a number of the 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.
digitsdigits 0에서 9 까지의 숫자 시퀀스입니다.A sequence of digits ranging from 0 to 9.

s 매개 변수는 NumberStyles.Integer 스타일을 사용 하 여 해석 됩니다.The s parameter is interpreted using the NumberStyles.Integer style. 바이트 값의 소수 자릿수 외에도 선행 및 후행 공백을 선행 양수 또는 음수 기호를 사용 하 여만 허용 됩니다.In addition to the byte value's decimal digits, only leading and trailing spaces with a leading positive or negative sign are allowed. s에 나타날 수 있는 스타일 요소를 명시적으로 정의 하려면 Parse(String, NumberStyles) 또는 Parse(String, NumberStyles, IFormatProvider) 메서드를 사용 합니다.To explicitly define the style elements that can be present in s, use either the Parse(String, NumberStyles) or the Parse(String, NumberStyles, IFormatProvider) method.

s 매개 변수는 현재 시스템 문화권에 대해 초기화 된 NumberFormatInfo 형식 지정 정보를 사용 하 여 구문 분석 됩니다.The s parameter is parsed by using the formatting information in a NumberFormatInfo that is initialized for the current system culture. 자세한 내용은 NumberFormatInfo.CurrentInfo을 참조하세요.For more information, see NumberFormatInfo.CurrentInfo. 다른 문화권의 서식 지정 정보를 사용 하 여 문자열을 구문 분석 하려면 Parse(String, NumberStyles, IFormatProvider) 메서드를 사용 합니다.To parse a string by using the formatting information of some other culture, use the Parse(String, NumberStyles, IFormatProvider) method.

추가 정보

Parse(String, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

CLS 대체 규격
System.Int16.Parse(String)

지정된 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 8비트 부호 있는 정수로 변환합니다.Converts the string representation of a number in a specified culture-specific format to its 8-bit signed integer equivalent.

public:
 static System::SByte Parse(System::String ^ s, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static sbyte Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> sbyte
Public Shared Function Parse (s As String, provider As IFormatProvider) As SByte

매개 변수

s
String

변환할 숫자를 나타내는 문자열입니다.A string that represents a number to convert. 이 문자열은 Integer 스타일을 사용하여 해석됩니다.The string is interpreted using the Integer style.

provider
IFormatProvider

s에 대한 문화권별 형식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information about s. providernull이면 현재 스레드 문화권이 사용됩니다.If provider is null, the thread current culture is used.

반환

s에 지정된 숫자에 해당하는 8비트 부호 있는 정수입니다.An 8-bit signed integer that is equivalent to the number specified in s.

특성

예외

snull인 경우s is null.

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

sMinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다.s represents a number less than MinValue or greater than MaxValue.

예제

다음 예제에서는 물결표 (~)를 음수 기호로 정의 하는 사용자 지정 NumberFormatInfo 개체를 정의 합니다.The following example defines a custom NumberFormatInfo object that defines the tilde (~) as the negative sign. 그런 다음이 사용자 지정 NumberFormatInfo 개체 및 고정 문화권을 나타내는 CultureInfo 개체를 사용 하 여 숫자 문자열 수를 구문 분석 합니다.It then parses a number of numeric strings using this custom NumberFormatInfo object as well as a CultureInfo object that represents the invariant culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberFormatInfo nf = new NumberFormatInfo();
      nf.NegativeSign = "~"; 
      
      string[] values = { "-103", "+12", "~16", "  1", "~255" };
      IFormatProvider[] providers = { nf, CultureInfo.InvariantCulture };
      
      foreach (IFormatProvider provider in providers)
      {
         Console.WriteLine("Conversions using {0}:", ((object) provider).GetType().Name);
         foreach (string value in values)
         {
            try {
               Console.WriteLine("   Converted '{0}' to {1}.", 
                                 value, SByte.Parse(value, provider));
            }                     
            catch (FormatException) {
               Console.WriteLine("   Unable to parse '{0}'.", value);   
            }
            catch (OverflowException) {
               Console.WriteLine("   '{0}' is out of range of the SByte type.", value);         
            }
         }
      }      
   }
}
// The example displays the following output:
//       Conversions using NumberFormatInfo:
//          Unable to parse '-103'.
//          Converted '+12' to 12.
//          Converted '~16' to -16.
//          Converted '  1' to 1.
//          '~255' is out of range of the SByte type.
//       Conversions using CultureInfo:
//          Converted '-103' to -103.
//          Converted '+12' to 12.
//          Unable to parse '~16'.
//          Converted '  1' to 1.
//          Unable to parse '~255'.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim nf As New NumberFormatInfo()
      nf.NegativeSign = "~" 
      
      Dim values() As String = { "-103", "+12", "~16", "  1", "~255" }
      Dim providers() As IFormatProvider = { nf, CultureInfo.InvariantCulture }
      
      For Each provider As IFormatProvider In providers
         Console.WriteLine("Conversions using {0}:", CObj(provider).GetType().Name)
         For Each value As String In values
            Try
               Console.WriteLine("   Converted '{0}' to {1}.", _
                                 value, SByte.Parse(value, provider))
            Catch e As FormatException
               Console.WriteLine("   Unable to parse '{0}'.", value)   
            Catch e As OverflowException
               Console.WriteLine("   '{0}' is out of range of the SByte type.", value)         
            End Try
         Next
      Next      
   End Sub
End Module
' The example displays '
'       Conversions using NumberFormatInfo:
'          Unable to parse '-103'.
'          Converted '+12' to 12.
'          Converted '~16' to -16.
'          Converted '  1' to 1.
'          '~255' is out of range of the SByte type.
'       Conversions using CultureInfo:
'          Converted '-103' to -103.
'          Converted '+12' to 12.
'          Unable to parse '~16'.
'          Converted '  1' to 1.
'          Unable to parse '~255'.

설명

s 매개 변수에는 다음과 같은 형식이 포함 됩니다.The s parameter contains a number of the 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.
digitsdigits 0에서 9 까지의 숫자 시퀀스입니다.A sequence of digits ranging from 0 to 9.

s 매개 변수는 Integer 스타일을 사용 하 여 해석 됩니다.The s parameter is interpreted using the Integer style. 바이트 값의 소수 자릿수 외에도 선행 및 후행 공백을 앞에 부호가 허용 됩니다.In addition to the byte value's decimal digits, only leading and trailing spaces with a leading sign are allowed. s에 나타날 수 있는 문화권별 서식 지정 정보를 사용 하 여 스타일 요소를 명시적으로 정의 하려면 Parse(String, NumberStyles, IFormatProvider) 메서드를 사용 합니다.To explicitly define the style elements with the culture-specific formatting information that can be present in s, use the Parse(String, NumberStyles, IFormatProvider) method.

provider 매개 변수는 GetFormat 메서드가 s형식에 대 한 문화권별 정보를 제공 하는 NumberFormatInfo 개체를 반환 하는 IFormatProvider 구현입니다.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. provider 매개 변수를 사용 하 여 구문 분석 작업에 사용자 지정 서식 지정 정보를 제공 하는 방법에는 세 가지가 있습니다.There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 서식 지정 정보를 제공 하는 실제 NumberFormatInfo 개체를 전달할 수 있습니다.You can pass the actual NumberFormatInfo object that provides formatting information. GetFormat의 구현은 단순히 자신을 반환 합니다.(Its implementation of GetFormat simply returns itself.)

  • 서식 지정을 사용할 문화권을 지정 하는 CultureInfo 개체를 전달할 수 있습니다.You can pass a CultureInfo object that specifies the culture whose formatting is to be used. 해당 NumberFormat 속성은 서식 지정 정보를 제공 합니다.Its NumberFormat property provides formatting information.

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

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

추가 정보

적용 대상