SByte.TryParse 메서드

정의

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

오버로드

TryParse(String, SByte)

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

TryParse(ReadOnlySpan<Char>, SByte)

숫자의 범위 표현을 해당하는 SByte로 변환하고, 변환이 성공했는지를 나타내는 값을 반환하도록 시도합니다.Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, NumberStyles, IFormatProvider, SByte)

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

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

지정된 스타일 및 문화권별 지정 형식으로 된 숫자의 범위 표현을 해당하는 SByte로 변환하고, 변환이 성공했는지를 나타내는 값을 반환하도록 시도합니다.Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, SByte)

중요

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

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

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

매개 변수

s
String

변환할 숫자가 포함된 문자열입니다.A string that contains a number to convert.

result
SByte

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

반환

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

특성

예제

다음 예제에서는 TryParse(String, SByte) 메서드를 호출 하 여 배열의 문자열을 SByte 값으로 변환 하려고 시도 합니다.The following example tries to convert the strings in an array to SByte values by calling the TryParse(String, SByte) method.

string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.
Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", "    3   ", _
                                  "(17)", "-17", "+12", "18-", "987", _
                                  "1,024", "  127 "}
Dim number As SByte
For Each numericString As String In numericStrings
   If SByte.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
   End If      
Next
' The example displays the following output to the console:
'       Cannot convert '-3.6' to an SByte.
'       Cannot convert '12.8' to an SByte.
'       Cannot convert '+16.7' to an SByte.
'       Converted '    3   ' to 3.
'       Cannot convert '(17)' to an SByte.
'       Converted '-17' to -17.
'       Converted '+12' to 12.
'       Cannot convert '18-' to an SByte.
'       Cannot convert '987' to an SByte.
'       Cannot convert '1,024' to an SByte.
'       Converted '  127 ' to 127.

설명

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

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.

참고

value 매개 변수에 의해 지정 된 문자열은 그룹 구분 기호 또는 소수 구분 기호를 포함할 수 없으며 소수 부분을 포함할 수 없습니다.The string specified by the value 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. value에 나타날 수 있는 문화권별 서식 지정 정보를 사용 하 여 스타일 요소를 명시적으로 정의 하려면 TryParse(String, NumberStyles, IFormatProvider, SByte) 메서드를 호출 합니다.To explicitly define the style elements with the culture-specific formatting information that can be present in value, call the TryParse(String, NumberStyles, IFormatProvider, SByte) method.

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

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

추가 정보

TryParse(ReadOnlySpan<Char>, SByte)

중요

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

숫자의 범위 표현을 해당하는 SByte로 변환하고, 변환이 성공했는지를 나타내는 값을 반환하도록 시도합니다.Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

매개 변수

s
ReadOnlySpan<Char>

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

result
SByte

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

반환

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

특성

TryParse(String, NumberStyles, IFormatProvider, SByte)

중요

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

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

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

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

매개 변수

s
String

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

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
SByte

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 8비트 부호 있는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 8-bit signed 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.

반환

true가 성공적으로 변환되었으면 s이고, 그렇지 않으면 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, SByte) 메서드를 호출 합니다.The following example calls the TryParse(String, NumberStyles, IFormatProvider, SByte) method with a number of different string and NumberStyles values.

using System;
using System.Globalization;

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

      numericString = "10E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "12E-01";
      CallTryParse(numericString, styles);
          
      numericString = "12E01";
      CallTryParse(numericString, styles); 
      
      numericString = "C8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      sbyte number;
      bool result = SByte.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 '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-106"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "103.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "10E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "12E-01"
      CallTryParse(numericString, styles)
          
      numericString = "12E01"
      CallTryParse(numericString, styles) 
      
      numericString = "C8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As SByte
      Dim result As Boolean = SByte.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 '106' to 106.
'       Attempted conversion of '-106' failed.
'       Converted '103.00' to 103.
'       Attempted conversion of '103.72' failed.
'       Converted '10E-01' to 1.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E01' to 120.
'       Converted 'C8' to -56.
'       Attempted conversion of '0x8C' failed.

설명

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

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

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

style 매개 변수에 AllowHexSpecifier포함 된 경우 value 매개 변수에 다음 요소가 포함 될 수 있습니다.If the style parameter includes AllowHexSpecifier, the value parameter may include the following elements:

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

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

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 공백은 style NumberStyles.AllowLeadingWhite 플래그를 포함 하거나 style 플래그가 포함 된 경우 value 끝에 value 표시 될 수 있습니다.NumberStyles.AllowTrailingWhiteWhite space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of value if style includes the NumberStyles.AllowTrailingWhite flag.
$ 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 플래그가 포함 된 경우 통화 기호가 value 나타날 수 있습니다.The currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 가 선택적 부호입니다.An optional sign. 기호는 styleNumberStyles.AllowLeadingSign 플래그가 포함 된 경우 value의 시작 부분에 나타날 수 있으며 style 플래그가 NumberStyles.AllowTrailingSign에 포함 된 경우 value의 끝에 나타날 수 있습니다.The sign can appear at the start of value if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingSign flag. value에서 괄호를 사용 하 여 style NumberStyles.AllowParentheses 플래그가 포함 된 경우 음수 값을 나타낼 수 있습니다.Parentheses can be used in value to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9.
,, Culture 별 그룹 구분 기호입니다.A culture-specific group separator. provider로 지정 된 문화권의 그룹 구분 기호는 styleNumberStyles.AllowThousands 플래그가 포함 된 경우 value에 표시 될 수 있습니다.The group separator of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol. provider로 지정 된 문화권의 소수점 기호는 styleNumberStyles.AllowDecimalPoint 플래그가 포함 된 경우 value에 나타날 수 있습니다.The decimal point symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 숫자 0 개 이상의 발견 합니다.One or more occurrences of the digit 0. 소수 자릿수는 style NumberStyles.AllowDecimalPoint 플래그를 포함 하는 경우에만 value 표시 될 수 있습니다.Fractional digits can appear in value only if style includes the NumberStyles.AllowDecimalPoint flag.
EE "E" 또는 "E" 문자 값은 지 수 (과학적 표기법) 표기법으로 표현 됨을 나타내는입니다.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits 0부터 9 까지의 숫자 시퀀스입니다.A sequence of digits from 0 through 9. style NumberStyles.AllowExponent 플래그가 포함 된 경우 value 매개 변수는 지 수 표기법으로 숫자를 나타낼 수 있습니다.The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 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 멤버가 value에 있을 수 있는 요소에 미치는 영향을 보여 줍니다.The following table indicates how individual NumberStyles members affect the elements that may be present in value.

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

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

참고

value 16 진수의 문자열 표현인 경우 16 진수를 구분 하는 데코레이션 (예: 0x 또는 &h) 앞에 올 수 없습니다.If value is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. 이렇게 하면 변환이 실패할 수 있습니다.This causes the conversion to fail.

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

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

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

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

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

추가 정보

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

중요

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

지정된 스타일 및 문화권별 지정 형식으로 된 숫자의 범위 표현을 해당하는 SByte로 변환하고, 변환이 성공했는지를 나타내는 값을 반환하도록 시도합니다.Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

매개 변수

s
ReadOnlySpan<Char>

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

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
SByte

이 메서드는 변환이 성공한 경우 s에 포함된 숫자에 해당하는 8비트 부호 있는 정수 값을 반환하고, 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the 8-bit signed 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.

반환

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

특성

적용 대상