Single.TryParse Single.TryParse Single.TryParse Single.TryParse Method

정의

숫자의 문자열 표현을 해당하는 단정밀도 부동 소수점 숫자로 변환합니다.Converts the string representation of a number to its single-precision floating-point number equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

오버로드

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)
TryParse(String, Single) TryParse(String, Single) TryParse(String, Single) TryParse(String, Single)

숫자의 문자열 표현을 해당하는 단정밀도 부동 소수점 숫자로 변환합니다.Converts the string representation of a number to its single-precision floating-point number equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single)
TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single)

지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 단정밀도 부동 소수점 숫자로 변환합니다.Converts the string representation of a number in a specified style and culture-specific format to its single-precision floating-point number equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

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

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

매개 변수

반환

TryParse(String, Single) TryParse(String, Single) TryParse(String, Single) TryParse(String, Single)

숫자의 문자열 표현을 해당하는 단정밀도 부동 소수점 숫자로 변환합니다.Converts the string representation of a number to its single-precision floating-point number equivalent. 반환 값은 변환이 성공했는지 아니면 실패했는지를 나타냅니다.A return value indicates whether the conversion succeeded or failed.

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

매개 변수

s
String String String String

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

result
Single Single Single Single

이 메서드는 변환이 성공한 경우 s에 포함된 숫자 값이나 기호에 해당하는 단정밀도 부동 소수점 숫자를 반환하며 변환이 실패한 경우 0을 반환합니다.When this method returns, contains single-precision floating-point number equivalent to the numeric value or symbol 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 a number in a valid format, 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.

예제

다음 예제에서는 합니다 TryParse(String, Single) 숫자 값의 문자열 표현으로 변환할 방법이 Single 값입니다.The following example uses the TryParse(String, Single) method to convert the string representations of numeric values to Single values. 해당 EN-US가 현재 문화권이 가정 합니다.It assumes that en-US is the current culture.

string value;
float number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);      

// Parse a floating-point value with a currency symbol and a 
// thousands separator.
value = "$1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   

// Parse value in exponential notation.
value = "-1.643e6";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   

// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.68934617882109E+17
Dim value As String
Dim number As Single

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)      
End If   

' Parse a floating-point value with a currency symbol and a 
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)  
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If

' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If

' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If
' The example displays the following output:
'       1643.57
'       Unable to parse '$1,643.57'.
'       -1643000
'       -1.68934617882109E+17

설명

다른이 오버 로드는 Single.Parse(String) 메서드 구문 분석된 된 숫자 값을 반환 하는 대신 구문 분석 작업이 성공 했는지를 나타내는 부울 값을 반환 합니다.This overload differs from the Single.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. 테스트 하기 위해 예외 처리를 사용할 필요가 한 FormatException 이벤트에 s 잘못 되었으며 성공적으로 구문 분석할 수 없습니다.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

합니다 s 매개 변수를 포함할 수 있습니다 PositiveInfinitySymbolNegativeInfinitySymbol, NaNSymbol (문자열 비교는 대/소문자 구분) 또는 폼의 문자열:The s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol (the string comparison is case-sensitive), or a string of the form:

[ws][sign][integral-digits,]integral-digits[.[fractional-digits]][e[sign]exponential-digits][ws][ws][sign][integral-digits,]integral-digits[.[fractional-digits]][e[sign]exponential-digits][ws]

대괄호 안의 요소는 선택 사항입니다.Elements in square brackets are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element.

요소Element 설명Description
wsws 일련의 공백 문자입니다.A series of white-space characters.
signsign 음수 기호 또는 양수 부호 기호입니다.A negative sign or positive sign symbol.
integral-digitsintegral-digits 일련의 숫자 0에서 하는 9 사이의 숫자의 정수 부분을 지정 합니다.A series of numeric characters ranging from 0 to 9 that specify the integral part of the number. 정수 계열 숫자 수 없어야 경우 소수 자릿수입니다.Integral-digits can be absent if there are fractional-digits.
,, Culture 별 그룹 구분 기호입니다.A culture-specific group separator symbol.
.. Culture 별 소수점 기호입니다.A culture-specific decimal point symbol.
fractional-digitsfractional-digits 일련의 숫자 0에서 하는 9 사이의 숫자의 소수 부분을 지정 합니다.A series of numeric characters ranging from 0 to 9 that specify the fractional part of the number.
EE 대 / 소문자 구분 문자가 'e'를 지 수 (과학적 표기법) 표기법을 나타냅니다.An uppercase or lowercase character 'e', that indicates exponential (scientific) notation.
exponential-digitsexponential-digits 일련의 0에서 9 지 수를 지정 하는 위치 까지의 숫자입니다.A series of numeric characters ranging from 0 to 9 that specify an exponent.

s 매개 변수를 조합 하 여 해석 되는 NumberStyles.FloatNumberStyles.AllowThousands 플래그입니다.The s parameter is interpreted using a combination of the NumberStyles.Float and NumberStyles.AllowThousands flags. 즉, 공백이 고 천 단위 구분 기호는 사용할 수 있지만 통화 기호는 없습니다.This means that white space and thousands separators are allowed but currency symbols are not. 요소를 명시적으로 정의 하려면 (통화 기호, 1000 단위와 같은 구분 기호 및 공백을)에 나타날 수 있는 s를 사용 하 여를 TryParse(String, NumberStyles, IFormatProvider, Single) 메서드 오버 로드.To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the TryParse(String, NumberStyles, IFormatProvider, Single) method overload.

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

일반적으로 전달 하는 경우는 Single.TryParse 메서드를 호출 하 여 만든 문자열을 Single.ToString 메서드를 원래 Single 값이 반환 됩니다.Ordinarily, if you pass the Single.TryParse method a string that is created by calling the Single.ToString method, the original Single value is returned. 그러나 정밀도의 손실, 인해 값 아닐 같은 합니다.However, because of a loss of precision, the values may not be equal.

구분 기호에서 발견 되는 s 구문 분석 작업을 하 고 해당 통화 또는 10 진수 수 중에 매개 변수 및 그룹 구분 기호는 동일, 구문 분석 작업이 구분 기호는 그룹 보다는 소수 구분 기호로 간주 구분 기호입니다.If a separator is encountered in the s parameter during a parse operation, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. 구분 기호에 대 한 자세한 내용은 참조 하세요. CurrencyDecimalSeparator, NumberDecimalSeparatorCurrencyGroupSeparator, 및 NumberGroupSeparator합니다.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

추가 정보

TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single)

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, out float result);
static member TryParse : ReadOnlySpan<char> * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Single) As Boolean

매개 변수

반환

TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single)

지정된 스타일 및 문화권별 형식으로 된 숫자의 문자열 표현을 해당하는 단정밀도 부동 소수점 숫자로 변환합니다.Converts the string representation of a number in a specified style and culture-specific format to its single-precision floating-point number 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] float % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

매개 변수

s
String String String String

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

style
NumberStyles NumberStyles NumberStyles NumberStyles

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

result
Single Single Single Single

이 메서드는 변환이 성공한 경우 s에 포함된 숫자 값이나 기호에 해당하는 단정밀도 부동 소수점 숫자를 반환하며 변환이 실패한 경우 0을 반환합니다.When this method returns, contains the single-precision floating-point number equivalent to the numeric value or symbol contained in s, if the conversion succeeded, or zero if the conversion failed. s 매개 변수가 null 또는 Empty이거나, style과 규격 형식이 아니거나, MinValue보다 작거나 MaxValue보다 큰 숫자를 나타내거나, styleNumberStyles 열거형 상수의 유효한 조합이 아닌 경우 변환이 실패합니다.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, represents a number less than MinValue or greater than MaxValue, or if style is not a valid combination of NumberStyles enumerated constants. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 원래 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- styleAllowHexSpecifier 값입니다.style is the AllowHexSpecifier value.

예제

다음 예제에서는 사용 된 Single.TryParse(String, NumberStyles, IFormatProvider, Single) 특정 스타일 및 서식을 특정 문화권의 규칙을 사용 하는 숫자의 문자열 표현을 구문 분석 하는 방법입니다.The following example demonstrates the use of the Single.TryParse(String, NumberStyles, IFormatProvider, Single) method to parse the string representation of numbers that have a particular style and are formatted using the conventions of a particular culture.

string value;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = System.Globalization.NumberStyles.Number | 
        System.Globalization.NumberStyles.AllowCurrencySymbol;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1.345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint | 
        System.Globalization.NumberStyles.AllowThousands;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.
Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = System.Globalization.NumberStyles.Number Or _
        System.Globalization.NumberStyles.AllowCurrencySymbol
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1.345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint Or _
        System.Globalization.NumberStyles.AllowThousands
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' The example displays the following output:
'       Converted '£1,097.63' to 1097.63.
'       Converted '1345,978' to 1345.978.
'       Converted '1.345,978' to 1345.978.
'       Unable to convert '1 345,978'.

설명

다른이 오버 로드는 Parse(String, NumberStyles, IFormatProvider) 메서드 구문 분석된 된 숫자 값을 반환 하는 대신 구문 분석 작업이 성공 했는지를 나타내는 부울 값을 반환 합니다.This overload differs from the Parse(String, NumberStyles, IFormatProvider) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. 테스트 하기 위해 예외 처리를 사용할 필요가 한 FormatException 이벤트에 s 잘못 되었으며 성공적으로 구문 분석할 수 없습니다.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

합니다 style 의 허용 되는 형식을 정의 하는 매개 변수는 s 구문 분석 작업이 성공 하기 위해 매개 변수입니다.The style parameter defines the allowable format of the s parameter for the parse operation to succeed. 비트 플래그 조합 이어야 합니다는 NumberStyles 열거형입니다.It must be a combination of bit flags from the NumberStyles enumeration. 다음 NumberStyles 멤버가 지원 되지 않습니다.The following NumberStyles members are not supported:

합니다 s 매개 변수를 포함할 수 있습니다 PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol 하 여 지정 된 문화권 provider합니다.The s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol for the culture indicated by provider. 값에 따라 뿐만 style, s 매개 변수는 다음 요소가 포함 될 수 있습니다.In addition, depending on the value of style, the s parameter may include the following elements:

[ws] [$] [sign][integral-digits,]integral-digits[.fractional-digits][e[sign]exponential-digits][ws][ws] [$] [sign][integral-digits,]integral-digits[.fractional-digits][e[sign]exponential-digits][ws]

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

요소Element 설명Description
wsws 선택적 공백입니다.Optional white space. 맨 앞에 공백이 나타날 수 s 경우 style 포함 된 NumberStyles.AllowLeadingWhite 플래그입니다.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag. 끝에 나타날 수 있습니다 s 경우 style 포함 된 NumberStyles.AllowTrailingWhite 플래그입니다.It can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Culture 별 통화 기호입니다.A culture-specific currency symbol. 문자열의 해당 위치에서 정의 됩니다는 NumberFormatInfo.CurrencyNegativePattern 또는 NumberFormatInfo.CurrencyPositivePattern 의 속성을 NumberFormatInfo 에서 반환 된 개체를 IFormatProvider.GetFormat 메서드의 provider 매개 변수.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern or NumberFormatInfo.CurrencyPositivePattern properties of the NumberFormatInfo object returned by the IFormatProvider.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. 부호의 시작 부분에 나타날 수 있습니다 s 경우 style 포함 합니다 NumberStyles.AllowLeadingSign 끝에 있고, 나타날 수 있습니다 s 경우 style 포함를 NumberStyles.AllowTrailingSign 플래그 합니다.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. 괄호를 사용할 수 있습니다 s 경우 음수 값을 나타내는 데 style 포함 된 NumberStyles.AllowParentheses 플래그입니다.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
integral-digitsintegral-digits 일련의 0에서 숫자의 정수 부분을 지정 하는 9 까지의 숫자입니다.A series of digits ranging from 0 to 9 that specify the integral part of the number. 정수 계열 숫자 수 없어야 경우 소수 자릿수입니다.Integral-digits can be absent if there are fractional-digits.
,, 문화권별 천 단위 구분 기호입니다.A culture-specific thousands separator symbol. 현재 문화권의 천 단위 구분 기호에 나타날 수 있습니다 s 경우 style 포함는 NumberStyles.AllowThousands 플래그입니다.The current culture's thousands separator symbol 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.
fractional-digitsfractional-digits 일련의 0에서 숫자의 소수 부분을 지정 하는 9 까지의 숫자입니다.A series of digits ranging from 0 to 9 that specify the fractional part of the number. 소수 자릿수에 나타날 수 있습니다 s 하는 경우 style 포함 된 NumberStyles.AllowDecimalPoint 플래그입니다.Fractional digits can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
ee E 또는 E 문자는 나타내는 s 지 수 표기법을 사용 하 여 숫자를 나타낼 수 있습니다.The e or E character, which indicates that s can represent a number using exponential notation. 합니다 s 매개 변수 스타일을 포함 하는 경우 지 수 표기법으로 숫자를 나타낼 수는 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 series of digits ranging from 0 to 9 that specify an exponent.

참고

종료 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. 나머지 System.Globalization.NumberStyles 멤버 수 있지만 입력된 문자열에 있이 필요가 없습니다 있는 요소를 제어 합니다.The remaining System.Globalization.NumberStyles members control elements that may be but are not required to be present in the input string. 다음 표에서 개별 NumberStyles 플래그에 나타날 수 있는 요소에 영향을 줄 s합니다.The following table indicates how individual NumberStyles flags affect the elements that may be present in s.

NumberStyles 값NumberStyles value 숫자 외에도 s에 허용 되는 요소Elements permitted in s in addition to digits
None 합니다 정수 계열 숫자 요소에만 합니다.The integral-digits element only.
AllowDecimalPoint .The . 소수 자릿수 요소입니다.and fractional-digits elements.
AllowExponent s 매개 변수 지 수 표기법을 사용할 수도 있습니다.The s parameter can also use exponential notation. 자체적으로이 플래그는 폼 값을 지원 하며 정수 자릿수E자리 지 수 백오프추가; 플래그와 같은 요소를 사용 하 여 지 수 표기법에서 문자열을 구문 분석 하는 데 필요한 양수 또는 음수 기호를 소수점 기호This flag by itself supports values in the form integral-digitsEexponential-digits; additional flags are needed to successfully parse strings in exponential notation with such elements as positive or negative signs and decimal point symbols.
AllowLeadingWhite 합니다 ws 맨 앞에 요소 s합니다.The ws element at the beginning of s.
AllowTrailingWhite 합니다 ws 의 끝에 있는 요소 s합니다.The ws element at the end of s.
AllowLeadingSign 합니다 sign 맨 앞에 요소 s합니다.The sign element at the beginning 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 , element.
AllowCurrencySymbol 합니다 $ 요소입니다.The $ element.
Currency 모두.All. s 매개 변수를 16 진수 또는 지 수 표기법으로 숫자를에서 나타낼 수 없습니다.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
Float ws 시작과 끝 요소 s, 로그인 의 시작 부분 s, 및 합니다.The ws element at the beginning or end of s, sign at the beginning of s, and the . 기호입니다.symbol. s 매개 변수 지 수 표기법을 사용할 수도 있습니다.The s parameter can also use exponential notation.
Number ws, sign, 천 단위 구분 기호 (,), 및 소수점 (.) 요소입니다.The ws, sign, thousands separator (,), and decimal point (.) elements.
Any 모든 스타일을 제외 하 고 s 16 진수 숫자를 나타낼 수 없습니다.All styles, except s cannot represent a hexadecimal number.

provider 매개 변수는는 IFormatProvider 구현입니다 GetFormat 메서드가 반환 되는 NumberFormatInfo culture 별 서식 지정 정보를 제공 하는 개체.The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. 경우는 TryParse(String, NumberStyles, IFormatProvider, Single) 메서드가 호출 되 면 호출를 provider 매개 변수의 GetFormat 메서드 전달를 Type 나타내는 개체를 NumberFormatInfo 형식.When the TryParse(String, NumberStyles, IFormatProvider, Single) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. GetFormat 메서드가 반환 됩니다 합니다 NumberFormatInfo 개체의 형식에 대 한 정보를 제공 하는 s 매개 변수입니다.The GetFormat method then returns the NumberFormatInfo object that provides information about the format of the s parameter. 사용 하는 방법은 세 가지를 provider 매개 변수를 구문 분석 작업에 사용자 지정 서식 지정 정보를 제공 합니다.There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 전달할 수는 CultureInfo 서식 지정 정보를 제공 하는 문화권을 나타내는 개체입니다.You can pass 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 숫자 형식 지정 정보를 제공 하는 개체입니다.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (해당 구현의 GetFormat 자체를 반환 합니다.)(Its implementation of GetFormat just returns itself.)

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

경우 provider 됩니다 null의 서식을 s 기준으로 해석 됩니다는 NumberFormatInfo 현재 문화권의 개체입니다.If provider is null, the formatting of s is interpreted based on the NumberFormatInfo object of the current culture.

구분 기호에서 발견 되는 s 구문 분석 작업을 하 고 해당 통화 또는 10 진수 수 중에 매개 변수 및 그룹 구분 기호는 동일, 구문 분석 작업이 구분 기호는 그룹 보다는 소수 구분 기호로 간주 구분 기호입니다.If a separator is encountered in the s parameter during a parse operation, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. 구분 기호에 대 한 자세한 내용은 참조 하세요. CurrencyDecimalSeparator, NumberDecimalSeparatorCurrencyGroupSeparator, 및 NumberGroupSeparator합니다.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

추가 정보

적용 대상