UInt16.TryParse 메서드

정의

숫자의 문자열 표현을 해당하는 16비트 부호 없는 정수로 변환합니다.Converts the string representation of a number to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

오버로드

TryParse(String, UInt16)

숫자의 문자열 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 합니다.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt16)

숫자의 범위 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 시도합니다.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, UInt16)

지정된 스타일과 문화권별 서식으로 나타낸 숫자의 문자열 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 합니다.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

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

지정된 스타일과 문화권별 지정 형식으로 된 숫자의 범위 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 시도합니다.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

TryParse(String, UInt16)

중요

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

CLS 대체 규격
System.Int32.TryParse(String, Int32)

숫자의 문자열 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 합니다.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out ushort result);
static member TryParse : string * uint16 -> bool
Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean

매개 변수

s
String

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

result
UInt16

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 16비트 부호 없는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 16-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. s 매개 변수가 null 또는 Empty이거나 올바른 서식이 아니면 변환에 실패합니다.The conversion fails if the s parameter is null or Empty, is not in the correct format. , 또는 MinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다., or represents a number less than MinValue or greater than MaxValue. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 원래 result에 제공된 모든 값을 덮어쓰게 됩니다.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

반환

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

특성

예제

다음 예제에서는 문자열 배열의 각 요소에 대해 TryParse(String, UInt16) 메서드를 한 번씩 호출 합니다.The following example calls the TryParse(String, UInt16) method once for each element in a string array.

string[] numericStrings = { "1293.8", "+1671.7", "28347.",  
                            "   33113684  ", "(0)", "-0", "-1", 
                            "+1293617", "18-", "119870", "31,024", 
                            "  3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
   if (UInt32.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt32.
//       Cannot convert '+1671.7' to a UInt32.
//       Cannot convert '28347.' to a UInt32.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt32.
//       Converted '-0' to 0.
//       Cannot convert '-1' to a UInt32.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt32.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt32.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", 
                                  "   33113684  ", "(0)", "-0", "-1",
                                  "+1293617", "18-", "119870", 
                                  "31,024", "  3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
   If UInt32.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt32.
'       Cannot convert '+1671.7' to a UInt32.
'       Cannot convert '28347.' to a UInt32.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt32.
'       Converted '-0' to 0.
'       Cannot convert '-1' to a UInt32.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt32.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt32.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

설명

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

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

[ws] [sign] 숫자[ws][ws][sign]digits[ws]

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

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space.
signsign 가 선택적 부호입니다.An optional sign. 올바른 부호 문자는 현재 문화권의 NumberFormatInfo.NegativeSignNumberFormatInfo.PositiveSign 속성에 의해 결정 됩니다.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
digitsdigits 0에서 9 까지의 10 진수 시퀀스로,A sequence of decimal digits ranging from 0 to 9.

참고

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

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

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

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

추가 정보

TryParse(ReadOnlySpan<Char>, UInt16)

중요

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

숫자의 범위 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 시도합니다.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ushort result);
static member TryParse : ReadOnlySpan<char> * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UShort) As Boolean

매개 변수

s
ReadOnlySpan<Char>

변환할 숫자를 나타내는 문자를 포함하는 범위입니다.A span containing the characters representing the number to convert.

result
UInt16

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 16비트 부호 없는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 16-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. s 매개 변수가 null 또는 Empty이거나 올바른 서식이 아니면 변환에 실패합니다.The conversion fails if the s parameter is null or Empty, is not in the correct format. , 또는 MinValue보다 작거나 MaxValue보다 큰 숫자를 나타냅니다., or represents a number less than MinValue or greater than MaxValue. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 원래 result에 제공된 모든 값을 덮어쓰게 됩니다.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

반환

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

특성

TryParse(String, NumberStyles, IFormatProvider, UInt16)

중요

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

CLS 대체 규격
System.Int32.TryParse(String, Int32)

지정된 스타일과 문화권별 서식으로 나타낸 숫자의 문자열 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 합니다.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

매개 변수

s
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

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

provider
IFormatProvider

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

result
UInt16

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 16비트 부호 없는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 16-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. s 매개 변수가 null 또는 Empty이거나, 형식이 style과 호환되지 않거나, MinValue보다 작거나 MaxValue보다 큰 숫자를 나타내는 경우 변환이 실패합니다.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 원래 result에 제공된 모든 값을 덮어쓰게 됩니다.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

반환

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

특성

예외

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

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

예제

다음 예제에서는 다양 한 문자열과 NumberStyles 값을 사용 하 여 TryParse(String, NumberStyles, IFormatProvider, UInt16) 메서드를 호출 합니다.The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt16) method with a number of different strings and NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "10603";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "2210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ushort number;
      bool result = UInt16.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output:
//       Converted '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10603"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "2210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UShort
      Dim result As Boolean = UInt16.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '10603' to 10603.
'       Attempted conversion of '-10603' failed.
'       Converted '29103.00' to 29103.
'       Attempted conversion of '10345.72' failed.
'       Converted '2210E-01' to 221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC8' to 65480.
'       Attempted conversion of '0x8F8C' failed.

설명

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

style 매개 변수는 구문 분석 작업이 성공 하기 위해 s 매개 변수에 허용 되는 스타일 요소 (예: 공백 또는 긍정 또는 음수 기호)를 정의 합니다.The style parameter defines the style elements (such as white space or a positive or negative sign) 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,]digits[.fractional_digits][E[sign]exponential_digits][ws]

대괄호 ([및])는 선택 사항에 대 한 항목입니다.Items in square brackets ([ and ]) are optional. 또는 style 매개 변수에 AllowHexSpecifier포함 되어 있는 경우 s 매개 변수에 다음 요소가 포함 될 수 있습니다.Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

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

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

wsws
선택적 공백입니다.Optional white space. 공백은 style NumberStyles.AllowLeadingWhite 플래그를 포함 하거나 style 플래그가 포함 된 경우 s 끝에 s 표시 될 수 있습니다.NumberStyles.AllowTrailingWhiteWhite space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.

$
Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열에서의 해당 위치는 provider 매개 변수의 GetFormat 메서드에서 반환 되는 NumberFormatInfo 개체의 CurrencyPositivePattern 속성에 의해 정의 됩니다.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. style NumberStyles.AllowCurrencySymbol 플래그가 포함 된 경우 통화 기호가 s 나타날 수 있습니다.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
가 선택적 부호입니다.An optional sign. 기호는 styleNumberStyles.AllowLeadingSign 플래그가 포함 된 경우 s의 시작 부분에 나타날 수 있으며 style 플래그가 NumberStyles.AllowTrailingSign에 포함 된 경우 s의 끝에 나타날 수 있습니다.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. 그러나 음수 부호가 있으면 구문 분석 작업이 성공 하기 위해 s 0만 나타낼 수 있습니다.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.

digitsdigits
0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.

,,
Culture 별 그룹 구분 기호입니다.A culture-specific group separator. provider로 지정 된 문화권의 그룹 구분 기호는 styleNumberStyles.AllowThousands 플래그가 포함 된 경우 s에 표시 될 수 있습니다.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.

..
Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. provider로 지정 된 문화권의 소수점 기호는 styleNumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 s에 나타날 수 있습니다.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.

fractional_digitsfractional_digits
숫자 0 개 이상의 발견 합니다.One or more occurrences of the digit 0. 소수 자릿수는 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 flag) always parses successfully. 나머지 NumberStyles 멤버 대부분은 표시 될 수 있지만 반드시 필요한 것은 아니지만이 입력 문자열에 있는 요소를 제어 합니다.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. 다음 표에서는 개별 NumberStyles 멤버가 s에 있을 수 있는 요소에 미치는 영향을 보여 줍니다.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

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

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. style에 나타날 수 있는 다른 플래그는 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhite입니다.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. NumberStyles 열거형에는 공백 플래그를 모두 포함 하는 복합 스타일 HexNumber있습니다.(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

참고

s 16 진수의 문자열 표현인 경우 16 진수를 구분 하는 데코레이션 (예: 0x 또는 &h) 앞에 올 수 없습니다.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.

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

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

  • 숫자 형식 지정 정보를 제공 하는 NumberFormatInfo 개체입니다.A NumberFormatInfo object that provides numeric formatting information. (GetFormat의 구현은 자신을 반환 하기만 합니다.)(Its implementation of GetFormat just returns itself.)

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

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

추가 정보

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

중요

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

지정된 스타일과 문화권별 지정 형식으로 된 숫자의 범위 표현을 해당하는 16비트 부호 없는 정수로 변환하려고 시도합니다.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

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

매개 변수

s
ReadOnlySpan<Char>

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

style
NumberStyles

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

provider
IFormatProvider

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

result
UInt16

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 16비트 부호 없는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 16-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. s 매개 변수가 null 또는 Empty이거나, 형식이 style과 호환되지 않거나, MinValue보다 작거나 MaxValue보다 큰 숫자를 나타내는 경우 변환이 실패합니다.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 원래 result에 제공된 모든 값을 덮어쓰게 됩니다.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

반환

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

특성

적용 대상