UInt16.Parse UInt16.Parse UInt16.Parse UInt16.Parse Method

정의

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

오버로드

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

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

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

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

이 메서드는 CLS 규격이 아닙니다.This method is not CLS-compliant. CLS 규격 대체 항목은 Parse(String, NumberStyles)입니다.The CLS-compliant alternative is Parse(String, NumberStyles).

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

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

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

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

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

중요

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

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

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

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

매개 변수

s
String String String String

변환할 숫자를 나타내는 문자열입니다.A string that represents the number to convert. 이 문자열은 style 매개 변수로 지정된 스타일을 사용하여 해석됩니다.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

s에 지정된 수에 해당하는 16비트 부호 없는 정수입니다.A 16-bit unsigned integer equivalent to the number specified in s.

예외

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

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

sstyle 규격 형식이 아닙니다.s is not in a format 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) 숫자의 다양 한 문자열 표현을 16 비트 부호 없는 정수 값으로 변환 하는 메서드.The following example uses the Parse(String, NumberStyles, IFormatProvider) method to convert various string representations of numbers to 16-bit unsigned integer values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames = { "en-US", "fr-FR" };
      NumberStyles[] styles= { NumberStyles.Integer, 
                               NumberStyles.Integer | NumberStyles.AllowDecimalPoint };
      string[] values = { "1702", "+1702.0", "+1702,0", "-1032.00",
                          "-1032,00", "1045.1", "1045,1" };
      
      // Parse strings using each culture
      foreach (string cultureName in cultureNames)
      {
         CultureInfo ci = new CultureInfo(cultureName);
         Console.WriteLine("Parsing strings using the {0} culture", 
                           ci.DisplayName);
         // Use each style.
         foreach (NumberStyles style in styles)
         {
            Console.WriteLine("   Style: {0}", style.ToString());
            // Parse each numeric string.
            foreach (string value in values)
            {
               try {
                  Console.WriteLine("      Converted '{0}' to {1}.", value, 
                                    UInt16.Parse(value, style, ci));
               }                                    
               catch (FormatException) {
                  Console.WriteLine("      Unable to parse '{0}'.", value);   
               }
               catch (OverflowException) {
                  Console.WriteLine("      '{0}' is out of range of the UInt16 type.", 
                                    value);
               }
            }
         }
      }   
   }
}
// The example displays the following output:
//       Parsing strings using the English (United States) culture
//          Style: Integer
//             Converted '1702' to 1702.
//             Unable to parse '+1702.0'.
//             Unable to parse '+1702,0'.
//             Unable to parse '-1032.00'.
//             Unable to parse '-1032,00'.
//             Unable to parse '1045.1'.
//             Unable to parse '1045,1'.
//          Style: Integer, AllowDecimalPoint
//             Converted '1702' to 1702.
//             Converted '+1702.0' to 1702.
//             Unable to parse '+1702,0'.
//             '-1032.00' is out of range of the UInt16 type.
//             Unable to parse '-1032,00'.
//             '1045.1' is out of range of the UInt16 type.
//             Unable to parse '1045,1'.
//       Parsing strings using the French (France) culture
//          Style: Integer
//             Converted '1702' to 1702.
//             Unable to parse '+1702.0'.
//             Unable to parse '+1702,0'.
//             Unable to parse '-1032.00'.
//             Unable to parse '-1032,00'.
//             Unable to parse '1045.1'.
//             Unable to parse '1045,1'.
//          Style: Integer, AllowDecimalPoint
//             Converted '1702' to 1702.
//             Unable to parse '+1702.0'.
//             Converted '+1702,0' to 1702.
//             Unable to parse '-1032.00'.
//             '-1032,00' is out of range of the UInt16 type.
//             Unable to parse '1045.1'.
//             '1045,1' is out of range of the UInt16 type.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR" }
      Dim styles() As NumberStyles = { NumberStyles.Integer, _
                                       NumberStyles.Integer Or NumberStyles.AllowDecimalPoint }
      Dim values() As String = { "1702", "+1702.0", "+1702,0", "-1032.00", _
                                 "-1032,00", "1045.1", "1045,1" }
      
      ' Parse strings using each culture
      For Each cultureName As String In cultureNames
         Dim ci As New CultureInfo(cultureName)
         Console.WriteLine("Parsing strings using the {0} culture", ci.DisplayName)
         ' Use each style.
         For Each style As NumberStyles In styles
            Console.WriteLine("   Style: {0}", style.ToString())
            ' Parse each numeric string.
            For Each value As String In values
               Try
                  Console.WriteLine("      Converted '{0}' to {1}.", value, _
                                    UInt16.Parse(value, style, ci))
               Catch e As FormatException
                  Console.WriteLine("      Unable to parse '{0}'.", value)   
               Catch e As OverflowException
                  Console.WriteLine("      '{0}' is out of range of the UInt16 type.", _
                                    value)         
               End Try
            Next
         Next
      Next                                    
   End Sub
End Module
' The example displays the following output:
'       Parsing strings using the English (United States) culture
'          Style: Integer
'             Converted '1702' to 1702.
'             Unable to parse '+1702.0'.
'             Unable to parse '+1702,0'.
'             Unable to parse '-1032.00'.
'             Unable to parse '-1032,00'.
'             Unable to parse '1045.1'.
'             Unable to parse '1045,1'.
'          Style: Integer, AllowDecimalPoint
'             Converted '1702' to 1702.
'             Converted '+1702.0' to 1702.
'             Unable to parse '+1702,0'.
'             '-1032.00' is out of range of the UInt16 type.
'             Unable to parse '-1032,00'.
'             '1045.1' is out of range of the UInt16 type.
'             Unable to parse '1045,1'.
'       Parsing strings using the French (France) culture
'          Style: Integer
'             Converted '1702' to 1702.
'             Unable to parse '+1702.0'.
'             Unable to parse '+1702,0'.
'             Unable to parse '-1032.00'.
'             Unable to parse '-1032,00'.
'             Unable to parse '1045.1'.
'             Unable to parse '1045,1'.
'          Style: Integer, AllowDecimalPoint
'             Converted '1702' to 1702.
'             Unable to parse '+1702.0'.
'             Converted '+1702,0' to 1702.
'             Unable to parse '-1032.00'.
'             '-1032,00' is out of range of the UInt16 type.
'             Unable to parse '1045.1'.
'             '1045,1' is out of range of the UInt16 type.

설명

합니다 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]digits[.fractional_digits][E[sign]exponential_digits][ws][ws][$][sign]digits[.fractional_digits][E[sign]exponential_digits][ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 하는 경우 style 포함 NumberStyles.AllowHexSpecifier, s 매개 변수는 다음 요소가 포함 될 수 있습니다.If style includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 맨 앞에 공백이 나타날 수 s 경우 style 포함 합니다 NumberStyles.AllowLeadingWhite 끝에 있고, 나타날 수 있습니다 s 경우 style 포함는 NumberStyles.AllowTrailingWhite 플래그입니다.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. 문자열의 해당 위치에서 정의 됩니다는 CurrencyPositivePattern 의 속성을 NumberFormatInfo 에서 반환 되는 개체를 GetFormat 메서드의 provider 매개 변수입니다.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object that is returned by the GetFormat method of the provider parameter. 통화 기호에 나타날 수 있습니다 s 경우 style 포함 된 NumberStyles.AllowCurrencySymbol 플래그입니다.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. (메서드가 throw를 OverflowException 경우 s 0이 아닌 값을 나타내고 음수 기호가 포함 되어 있습니다.) 부호의 시작 부분에 나타날 수 있습니다 s 경우 style 포함 합니다 NumberStyles.AllowLeadingSign 플래그를 하며의 끝에 나타날 수 있습니다 s 경우 style 포함를 NumberStyles.AllowTrailingSign 플래그.(The method throws an OverflowException if s includes a negative sign and represents a non-zero number.) The 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. 현재 문화권의 소수점 기호에 나타날 수 있습니다 s 경우 style 포함 된 NumberStyles.AllowDecimalPoint 플래그입니다.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 하나 이상의 숫자 0-9 개 경우 style 포함 된 NumberStyles.AllowExponent 하나 이상의 자리 하지 않는 경우에 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. 소수 자릿수에 나타날 수 있습니다 s 경우에만 style 포함 된 NumberStyles.AllowDecimalPoint 플래그입니다.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. s 매개 변수는 경우 지 수 표기법으로 숫자를 나타낼 수 style 포함 된 NumberStyles.AllowExponent 플래그.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. s 매개 변수는 경우 지 수 표기법으로 숫자를 나타낼 수 style 포함 된 NumberStyles.AllowExponent 플래그.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.

참고

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

진수만 포함 된 문자열 (해당 하는 NumberStyles.None 스타일) 항상 성공적으로 구문 분석 합니다.A string with 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 소수점 (합니다.) 및 소수 자릿수 요소입니다.The decimal point (.) and fractional_digits elements. 그러나 스타일 포함 되어 있지 않으면 합니다 NumberStyles.AllowExponent 플래그를 소수 자릿수 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 "E" 또는 "E" 문자를 함께 지 수 표기법으로 나타냅니다 지 수 표기법합니다.The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite 합니다 ws 맨 앞에 요소 s합니다.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite 합니다 ws 의 끝에 있는 요소 s합니다.The ws element at the end of s.
NumberStyles.AllowLeadingSign 앞에 기호 자릿수합니다.A sign before digits.
NumberStyles.AllowTrailingSign 다음에 부호 자릿수합니다.A sign after digits.
NumberStyles.AllowParentheses 앞과 뒤의 괄호 자릿수 음수 값을 나타냅니다.Parentheses before and after digits to indicate a negative value.
NumberStyles.AllowThousands 그룹 구분 기호 (,) 요소입니다.The group separator (,) element.
NumberStyles.AllowCurrencySymbol 통화 ($) 요소입니다.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 ~ 6. "0x"와 같은 접두사는 지원 되지 않습니다 및 하면 구문 분석 작업이 실패 합니다.Valid hexadecimal digits are 0 through 9, a through f, and A through F. A prefix, such as "0x", is not supported and causes the parse operation to fail. 만 다른 플래그와 결합 될 수 있는 NumberStyles.AllowHexSpecifier 됩니다 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be combined with NumberStyles.AllowHexSpecifier 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 진수 숫자의 문자열 표현, 모든 장식 하 여 뒤에 야 없습니다 (같은 0x 또는 &h) 16 진수 숫자로 구분 하는 합니다.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.

provider 매개 변수는는 IFormatProvider 구현입니다 GetFormat 메서드가 반환 되는 NumberFormatInfo 개체의 형식에 대 한 문화권별 형식 정보를 제공 하 s.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 됩니다 nullNumberFormatInfo 개체가 현재 문화권이 사용 됩니다.If provider is null, the NumberFormatInfo object for the current culture is used.

추가 정보

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

중요

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

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

매개 변수

반환

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

중요

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

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

이 메서드는 CLS 규격이 아닙니다.This method is not CLS-compliant. CLS 규격 대체 항목은 Parse(String, NumberStyles)입니다.The CLS-compliant alternative is Parse(String, NumberStyles).

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

매개 변수

s
String String String String

변환할 숫자를 나타내는 문자열입니다.A string that represents the number to convert. 이 문자열은 style 매개 변수로 지정된 스타일을 사용하여 해석됩니다.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles NumberStyles NumberStyles NumberStyles

s에 사용할 수 있는 서식을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify the permitted format of s. 지정할 일반적인 값은 Integer입니다.A typical value to specify is Integer.

반환

s에 지정된 수에 해당하는 16비트 부호 없는 정수입니다.A 16-bit unsigned integer equivalent to the number specified in s.

예외

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

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

sstyle 규격 형식이 아닙니다.s is not in a format 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.

예제

다음 예제에서는 여러 가지를 사용 하 여 문자열 배열의 각 요소를 구문 분석 하려고 NumberStyles 값입니다.The following example tries to parse each element in a string array by using a number of NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { " 214 ", "1,064", "(0)", "1241+", " + 214 ", " +214 ", "2153.0", "1e03", "1300.0e-2" };
      NumberStyles whitespace =  NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite;
      NumberStyles[] styles = { NumberStyles.None, whitespace, 
                                NumberStyles.AllowLeadingSign | NumberStyles.AllowTrailingSign | whitespace, 
                                NumberStyles.AllowThousands | NumberStyles.AllowCurrencySymbol, 
                                NumberStyles.AllowExponent | NumberStyles.AllowDecimalPoint };

      // Attempt to convert each number using each style combination.
      foreach (string value in values)
      {
         Console.WriteLine("Attempting to convert '{0}':", value);
         foreach (NumberStyles style in styles)
         {
            try {
               ushort number = UInt16.Parse(value, style);
               Console.WriteLine("   {0}: {1}", style, number);
            }   
            catch (FormatException) {
               Console.WriteLine("   {0}: Bad Format", style);
            }
         }
         Console.WriteLine();
      }
   }
}
// The example display the following output:
//    Attempting to convert ' 214 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: 214
//       Integer, AllowTrailingSign: 214
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '1,064':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: 1064
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '(0)':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '1241+':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 1241
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' + 214 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' +214 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 214
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '2153.0':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 2153
//    
//    Attempting to convert '1e03':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 1000
//    
//    Attempting to convert '1300.0e-2':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 13
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { " 214 ", "1,064", "(0)", "1241+", " + 214 ", " +214 ", "2153.0", "1e03", "1300.0e-2" }
      Dim whitespace As NumberStyles =  NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite
      Dim styles() As NumberStyles = { NumberStyles.None, _
                                       whitespace, _
                                       NumberStyles.AllowLeadingSign Or NumberStyles.AllowTrailingSign Or whitespace, _
                                       NumberStyles.AllowThousands Or NumberStyles.AllowCurrencySymbol, _
                                       NumberStyles.AllowExponent Or NumberStyles.AllowDecimalPoint }

      ' Attempt to convert each number using each style combination.
      For Each value As String In values
         Console.WriteLine("Attempting to convert '{0}':", value)
         For Each style As NumberStyles In styles
            Try
               Dim number As UShort = UInt16.Parse(value, style)
               Console.WriteLine("   {0}: {1}", style, number)
            Catch e As FormatException
               Console.WriteLine("   {0}: Bad Format", style)
            End Try         
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Attempting to convert ' 214 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: 214
'       Integer, AllowTrailingSign: 214
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '1,064':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: 1064
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '(0)':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '1241+':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 1241
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' + 214 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' +214 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 214
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '2153.0':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 2153
'    
'    Attempting to convert '1e03':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 1000
'    
'    Attempting to convert '1300.0e-2':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 13

설명

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

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

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

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다.Elements in square brackets ([ and ]) are optional. 하는 경우 style 포함 NumberStyles.AllowHexSpecifier, s 매개 변수는 다음 요소가 포함 될 수 있습니다.If style includes NumberStyles.AllowHexSpecifier, the s parameter may contain the following elements:

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

다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 공백의 시작 부분에 나타날 수 있습니다 s 경우 style 포함 합니다 NumberStyles.AllowLeadingWhite 끝에 있고, 나타날 수 있습니다 s 경우 style 포함를 NumberStyles.AllowTrailingWhite 플래그 합니다.White space can appear at the start 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.CurrencyNegativePatternNumberFormatInfo.CurrencyPositivePattern 현재 문화권의 속성입니다.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. 현재 문화권의 통화 기호에 나타날 수 있습니다 s 하는 경우 style 포함 된 NumberStyles.AllowCurrencySymbol 플래그 합니다.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 로그인의 시작 부분에 나타날 수 있습니다 s 경우 style 포함 합니다 NumberStyles.AllowLeadingSign 끝에 있고, 나타날 수 있습니다 s 경우 style 포함를 NumberStyles.AllowTrailingSign 플래그.The sign can appear at the start 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. 0에만 음수 기호를 사용할 수 있지만 그렇지 않으면 메서드가 throw는 OverflowException합니다.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
digitsdigits

fractional_digitsfractional_digits

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

참고

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

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

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

다른 달리 NumberStyles 값을 허용 하지만 특정 스타일 요소에 있으면 필요 하지 않습니다 sNumberStyles.AllowHexSpecifier 스타일 값의 개별 숫자 문자를 의미 s 항상로 해석 됩니다 16 진수 문자입니다.Unlike the other NumberStyles values, which allow for, but do not require, the presence of particular style elements in s, the NumberStyles.AllowHexSpecifier style value means that the individual numeric characters in s are always interpreted as hexadecimal characters. 유효한 16 진수는 0-9, A-f 및 a-f 문자입니다.Valid hexadecimal characters 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 with the style parameter 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 진수 숫자의 고 수 없습니다. 뒤에 야 모든 장식 (같은 0x 또는 &h) 16 진수 숫자로 구분 하는 합니다.If s 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.

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 specify the culture whose formatting information is used for the parse operation, call the Parse(String, NumberStyles, IFormatProvider) overload.

추가 정보

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

중요

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

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

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

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

매개 변수

s
String String String String

변환할 숫자를 나타내는 문자열입니다.A string that represents the number to convert.

반환

s에 있는 수에 해당하는 16비트 부호 없는 정수입니다.A 16-bit unsigned integer equivalent to the number contained in s.

예외

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

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

예제

다음 예제에서는 Parse(String) 문자열 배열의 각 요소에에서 부호 없는 16 비트 정수로 변환 하는 방법입니다.The following example calls the Parse(String) method to convert each element in a string array to an unsigned 16-bit integer.

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { "-0", "17", "-12", "185", "66012", "+0", 
                          "", null, "16.1", "28.0", "1,034" };
      foreach (string value in values)
      {
         try {
            ushort number = UInt16.Parse(value);
            Console.WriteLine("'{0}' --> {1}", value, number);
         }
         catch (FormatException) {
            Console.WriteLine("'{0}' --> Bad Format", value);
         }
         catch (OverflowException) {   
            Console.WriteLine("'{0}' --> OverflowException", value);
         }
         catch (ArgumentNullException) {
            Console.WriteLine("'{0}' --> Null", value);
         }
      }                                 
   }
}
// The example displays the following output:
//       '-0' --> 0
//       '17' --> 17
//       '-12' --> OverflowException
//       '185' --> 185
//       '66012' --> OverflowException
//       '+0' --> 0
//       '' --> Bad Format
//       '' --> Null
//       '16.1' --> Bad Format
//       '28.0' --> Bad Format
//       '1,034' --> Bad Format
Module Example
   Public Sub Main()
      Dim values() As String = { "-0", "17", "-12", "185", "66012", _ 
                                 "+0", "", Nothing, "16.1", "28.0", _
                                 "1,034" }
      For Each value As String In values
         Try
            Dim number As UShort = UInt16.Parse(value)
            Console.WriteLine("'{0}' --> {1}", value, number)
         Catch e As FormatException
            Console.WriteLine("'{0}' --> Bad Format", value)
         Catch e As OverflowException   
            Console.WriteLine("'{0}' --> OverflowException", value)
         Catch e As ArgumentNullException
            Console.WriteLine("'{0}' --> Null", value)
         End Try
      Next                                 
   End Sub
End Module
' The example displays the following output:
'       '-0' --> 0
'       '17' --> 17
'       '-12' --> OverflowException
'       '185' --> 185
'       '66012' --> OverflowException
'       '+0' --> 0
'       '' --> Bad Format
'       '' --> Null
'       '16.1' --> Bad Format
'       '28.0' --> Bad Format
'       '1,034' --> Bad Format

설명

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

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

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

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space.
signsign 가 선택적 부호입니다.An optional sign. 유효한 부호 문자는 기준 합니다 NumberFormatInfo.NegativeSignNumberFormatInfo.PositiveSign 현재 문화권의 속성입니다.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture. 0에만 음수 기호를 사용할 수 있지만 그렇지 않으면 메서드가 throw는 OverflowException합니다.However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
digitsdigits 0에서 9 까지의 숫자 시퀀스입니다.A sequence of digits ranging from 0 to 9. 모든 선행 0은 무시 됩니다.Any leading zeros are ignored.

참고

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

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

추가 정보

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

중요

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

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

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

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

매개 변수

s
String String String String

변환할 숫자를 나타내는 문자열입니다.A string that represents the number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

s에 지정된 수에 해당하는 16비트 부호 없는 정수입니다.A 16-bit unsigned integer equivalent to the number specified in s.

예외

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

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

예제

다음 예제에서는 두는 해당 양수 부호로 기호 (+ +)는 사용자 지정 문화권을 인스턴스화합니다.The following example instantiates a custom culture that uses two plus signs (++) as its positive sign. 그런 다음 호출 하는 Parse(String, IFormatProvider) 문자열의 배열을 사용 하 여 구문 분석 하는 방법 CultureInfo 이 사용자 지정 문화권 및 고정 문화권을 나타내는 개체입니다.It then calls the Parse(String, IFormatProvider) method to parse an array of strings by using CultureInfo objects that represent both this custom culture and the invariant culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define a custom culture that uses "++" as a positive sign. 
      CultureInfo ci = new CultureInfo("");
      ci.NumberFormat.PositiveSign = "++";
      // Create an array of cultures.
      CultureInfo[] cultures = { ci, CultureInfo.InvariantCulture };
      // Create an array of strings to parse.
      string[] values = { "++1403", "-0", "+0", "+16034", 
                          Int16.MinValue.ToString(), "14.0", "18012" };
      // Parse the strings using each culture.
      foreach (CultureInfo culture in cultures)
      {
         Console.WriteLine("Parsing with the '{0}' culture.", culture.Name);
         foreach (string value in values)
         {
            try {
               ushort number = UInt16.Parse(value, culture);
               Console.WriteLine("   Converted '{0}' to {1}.", value, number);
            }
            catch (FormatException) {
               Console.WriteLine("   The format of '{0}' is invalid.", value);
            }
            catch (OverflowException) {
               Console.WriteLine("   '{0}' is outside the range of a UInt16 value.", value);
            }               
         }
      }
   }
}
// The example displays the following output:
//       Parsing with the  culture.
//          Converted '++1403' to 1403.
//          Converted '-0' to 0.
//          The format of '+0' is invalid.
//          The format of '+16034' is invalid.
//          '-32768' is outside the range of a UInt16 value.
//          The format of '14.0' is invalid.
//          Converted '18012' to 18012.
//       Parsing with the '' culture.
//          The format of '++1403' is invalid.
//          Converted '-0' to 0.
//          Converted '+0' to 0.
//          Converted '+16034' to 16034.
//          '-32768' is outside the range of a UInt16 value.
//          The format of '14.0' is invalid.
//          Converted '18012' to 18012.
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define a custom culture that uses "++" as a positive sign. 
      Dim ci As CultureInfo = New CultureInfo("")
      ci.NumberFormat.PositiveSign = "++"
      ' Create an array of cultures.
      Dim cultures() As CultureInfo = { ci, CultureInfo.InvariantCulture }
      ' Create an array of strings to parse.
      Dim values() As String = { "++1403", "-0", "+0", "+16034", _
                                 Int16.MinValue.ToString(), "14.0", "18012" }
      ' Parse the strings using each culture.
      For Each culture As CultureInfo In cultures
         Console.WriteLine("Parsing with the '{0}' culture.", culture.Name)
         For Each value As String In values
            Try
               Dim number As UShort = UInt16.Parse(value, culture)
               Console.WriteLine("   Converted '{0}' to {1}.", value, number)
            Catch e As FormatException
               Console.WriteLine("   The format of '{0}' is invalid.", value)
            Catch e As OverflowException
               Console.WriteLine("   '{0}' is outside the range of a UInt16 value.", value)
            End Try               
         Next
      Next
   End Sub
End Module
' The example displays the following output:
'       Parsing with the  culture.
'          Converted '++1403' to 1403.
'          Converted '-0' to 0.
'          The format of '+0' is invalid.
'          The format of '+16034' is invalid.
'          '-32768' is outside the range of a UInt16 value.
'          The format of '14.0' is invalid.
'          Converted '18012' to 18012.
'       Parsing with the '' culture.
'          The format of '++1403' is invalid.
'          Converted '-0' to 0.
'          Converted '+0' to 0.
'          Converted '+16034' to 16034.
'          '-32768' is outside the range of a UInt16 value.
'          The format of '14.0' is invalid.
'          Converted '18012' to 18012.

설명

s 매개 변수 형식의 숫자를 포함 합니다.The s parameter contains a number of the form:

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

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

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space.
signsign 선택적 부호, 또는 음수 기호인 경우 s 0 값을 표시 합니다.An optional sign, or a negative sign if s represents the value zero.
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 along with a leading sign is allowed. (음수 기호를 표시 되 면 s 값이 0 또는 메서드가 throw 나타내야는 OverflowException.) 분명 하 게 함께 culture 별 서식 지정 정보에 포함 될 수 있는 스타일 요소를 정의할 s를 사용 하 여를 Parse(String, NumberStyles, IFormatProvider) 메서드.(If the negative sign is present, s must represent a value of zero or the method throws an OverflowException.) To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Parse(String, NumberStyles, IFormatProvider) method.

provider 매개 변수는는 IFormatProvider 구현입니다 GetFormat 메서드가 반환 되는 NumberFormatInfo 개체의 형식에 대 한 문화권별 형식 정보를 제공 하 s.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 for the current culture is used.

추가 정보

적용 대상