Single.ToString 메서드

정의

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation.

오버로드

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString(IFormatProvider)

지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString()

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation.

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

매개 변수

format
String

숫자 서식 문자열입니다.A numeric format string.

provider
IFormatProvider

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

반환

String

formatprovider로 지정된 이 인스턴스 값의 문자열 표현입니다.The string representation of the value of this instance as specified by format and provider.

구현

예제

다음 예제에서는 Single 다양 한 문화권에 대해 지원 되는 각 표준 숫자 서식 지정자를 사용 하 여 값을 표시 합니다.The following example displays a Single value using each of the supported standard numeric format specifiers for several different cultures.

float value = 16325.62901F;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62901

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.63

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004   

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.63

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,63

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %
Dim value As Single = 16325.62901
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62901

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.63

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.63

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,63

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

설명

메서드는 지정 된 ToString(String, IFormatProvider) Single 문화권의 지정 된 형식으로 값의 형식을 지정 합니다.The ToString(String, IFormatProvider) method formats a Single value in a specified format of a specified culture. 기본 형식 또는 문화권 설정을 사용 하려면 다음과 같이 메서드의 다른 오버 로드를 사용 합니다 ToString .If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권의 경우For culture 오버 로드 사용Use the overload
기본 ("G") 형식Default ("G") format 기본 (현재) 문화권Default (current) culture ToString()
기본 ("G") 형식Default ("G") format 특정 문화권A specific culture ToString(IFormatProvider)
특정 형식A specific format 기본 (현재) 문화권Default (current) culture ToString(String)

반환 값은 PositiveInfinitySymbolNegativeInfinitySymbol NaNSymbol 지정 된 대로,, 또는 현재 인스턴스의 값에 대 한 문자열 표현이 될 수 있습니다 format .The return value can be PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, or the string representation of the value of the current instance, as specified by format.

format매개 변수는 D와 X를 제외한 모든 유효한 표준 숫자 형식 지정자와 사용자 지정 숫자 형식 지정자의 조합을 사용할 수 있습니다.The format parameter can be any valid standard numeric format specifier except for D and X, as well as any combination of custom numeric format specifiers. format null 이 또는 빈 문자열인 경우이 인스턴스의 반환 값은 일반 숫자 형식 지정자 ("G")로 형식이 지정 됩니다.If format is null or an empty string, the return value for this instance is formatted with the general numeric format specifier ("G").

.NET Framework는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다.The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider매개 변수는 해당 IFormatProvider GetFormat 메서드가 개체를 반환 하는 구현입니다 NumberFormatInfo .The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object. 일반적으로 providerCultureInfo 개체 또는 NumberFormatInfo 개체입니다.Typically, provider is a CultureInfo object or a NumberFormatInfo object. provider매개 변수는 서식 지정에 사용 되는 문화권별 정보를 제공 합니다.The provider parameter supplies culture-specific information used in formatting. provider가 이면 null 반환 값은 NumberFormatInfo 현재 문화권에 대 한 개체를 사용 하 여 형식이 지정 됩니다.If provider is null, the return value is formatted with the NumberFormatInfo object for the current culture.

기본적으로 반환 값의 전체 자릿수는 7 자리 이지만 최대 9 자리는 내부적으로 유지 됩니다.By default, the return value only contains 7 digits of precision although a maximum of 9 digits is maintained internally. 이 인스턴스의 값이 7 자리 보다 큰 경우는 ToString PositiveInfinitySymbol NegativeInfinitySymbol 예상 된 수 대신 또는를 반환 합니다.If the value of this instance has greater than 7 digits, ToString returns PositiveInfinitySymbol or NegativeInfinitySymbol instead of the expected number. 더 많은 전체 자릿수가 필요한 경우에는 format 항상 9 자리 전체 자릿수를 반환 하는 "G9" 형식 지정을 사용 하 여을 지정 하 고, 숫자를 최대 전체 자릿수로 표현할 수 있는 경우 숫자를 해당 전체 자릿수 또는 9 자리로 표현할 수 있는 경우 7 자리를 반환 하는 "R"로 지정 합니다.If you require more precision, specify format with the "G9" format specification, which always returns 9 digits of precision, or "R", which returns 7 digits if the number can be represented with that precision or 9 digits if the number can only be represented with maximum precision.

추가 정보

적용 대상

ToString(String)

지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

매개 변수

format
String

숫자 서식 문자열입니다.A numeric format string.

반환

String

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.The string representation of the value of this instance as specified by format.

예외

format이 잘못되었습니다.format is invalid.

예제

다음 예에서는 숫자 값을 정의 하 고 "C" 표준 숫자 서식 문자열을 사용 하 여 통화 값으로 서식을 지정 하 고 "N" 표준 숫자 서식 문자열을 사용 하 여 숫자 값을 세 개의 소수 자릿수로 지정 합니다.The following example defines a numeric value and formats it as a currency value by using the "C" standard numeric format string and as a numeric value to three decimal places by using the "N" standard numeric format string. 결과 문자열의 형식은 en-us 문화권의 규칙을 사용 하 여 지정 됩니다.The result strings are formatted by using the conventions of the en-US culture. 숫자 형식 문자열에 대 한 자세한 내용은 표준 숫자 형식 문자열사용자 지정 숫자 형식 문자열을 참조 하세요.For more information on numeric format strings, see Standard Numeric Format Strings and Custom Numeric Format Strings.

using System;

public class Example
{
   public static void Main()
   {
      Double number = 1764.3789;
      
      // Format as a currency value.
      Console.WriteLine(number.ToString("C"));
      
      // Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"));
   }
}
// The example displays the following output:
//       $1,764.38
//       1,764.379
Module Example
   Public Sub Main()
      Dim number As Single = 1764.3789
      
      ' Format as a currency value.
      Console.WriteLine(number.ToString("C"))
      
      ' Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"))
   End Sub
End Module
' The example displays the following output:
'       $1,764.38
'       1,764.379

다음 예제에서는 Single 두 개의 사용자 지정 숫자 서식 문자열을 사용 하 여 지원 되는 각 표준 숫자 서식 지정자를 사용 하는 여러 값을 표시 합니다.The following example displays several Single values using each of the supported standard numeric format specifiers together with two custom numeric format strings. 이러한 사용자 지정 형식 문자열 중 하나는 Single 앞에 오는 0을 사용 하 여 값을 채우는 방법을 보여 줍니다.One of those custom format strings illustrates how to pad a Single value with leading zeros. 숫자 값을 문자열로 변환할 때이 예제에서는 en-us 문화권의 형식 규칙을 사용 합니다.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

float[] numbers= { 1054.32179F, -195489100.8377F, 1.0437E21F, 
                   -1.0573e-05F };
string[] specifiers = { "C", "E", "e", "F", "G", "N", "P", 
                        "R", "#,000.000", "0.###E-000",
                        "000,000,000,000.00###" };

foreach (float number in numbers)
{
   Console.WriteLine("Formatting of {0}:", number);
   foreach (string specifier in specifiers)
      Console.WriteLine("   {0,5}: {1}", 
                        specifier, number.ToString(specifier));

   Console.WriteLine();
}
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001 
Dim numbers() As Single = {1054.32179, -195489100.8377, 1.0437E21, _
                           -1.0573e-05}
Dim specifiers() As String = { "C", "E", "e", "F", "G", "N", "P", _
                               "R", "#,000.000", "0.###E-000", _
                               "000,000,000,000.00###"}
For Each number As Single In numbers
   Console.WriteLine("Formatting of {0}:", number)
   For Each specifier As String In specifiers
      Console.WriteLine("   {0,5}: {1}", _
                        specifier, number.ToString(specifier))
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       Formatting of 1054.32179:
'              C: $1,054.32
'              E: 1.054322E+003
'              e: 1.054322e+003
'              F: 1054.32
'              G: 1054.32179
'              N: 1,054.32
'              P: 105,432.18 %
'              R: 1054.32179
'          #,000.000: 1,054.322
'          0.###E-000: 1.054E003
'          000,000,000,000.00###: 000,000,001,054.322      
'       
'       Formatting of -195489100.8377:
'              C: ($195,489,100.84)
'              E: -1.954891E+008
'              e: -1.954891e+008
'              F: -195489100.84
'              G: -195489100.8377
'              N: -195,489,100.84
'              P: -19,548,910,083.77 %
'              R: -195489100.8377
'          #,000.000: -195,489,100.838
'          0.###E-000: -1.955E008
'          000,000,000,000.00###: -000,195,489,100.00
'       
'       Formatting of 1.0437E+21:
'              C: $1,043,700,000,000,000,000,000.00
'              E: 1.043700E+021
'              e: 1.043700e+021
'              F: 1043700000000000000000.00
'              G: 1.0437E+21
'              N: 1,043,700,000,000,000,000,000.00
'              P: 104,370,000,000,000,000,000,000.00 %
'              R: 1.0437E+21
'          #,000.000: 1,043,700,000,000,000,000,000.000
'          0.###E-000: 1.044E021
'          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
'       
'       Formatting of -1.0573E-05:
'              C: $0.00
'              E: -1.057300E-005
'              e: -1.057300e-005
'              F: 0.00
'              G: -1.0573E-05
'              N: 0.00
'              P: 0.00 %
'              R: -1.0573E-05
'          #,000.000: 000.000
'          0.###E-000: -1.057E-005
'          000,000,000,000.00###: -000,000,000,000.00001

설명

ToString(String)메서드는 Single 현재 문화권의 규칙을 사용 하 여 지정 된 형식의 값에 서식을 지정 합니다.The ToString(String) method formats a Single value in a specified format by using the conventions of the current culture. 기본 ("G" 또는 일반) 형식을 사용 하거나 다른 문화권을 지정 하려면 다음과 같이 메서드의 다른 오버 로드를 사용 합니다 ToString .If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권의 경우For culture 오버 로드 사용Use the overload
기본 ("G") 형식Default ("G") format 기본 (현재) 문화권Default (current) culture ToString()
기본 ("G") 형식Default ("G") format 특정 문화권A specific culture ToString(IFormatProvider)
특정 형식A specific format 특정 문화권A specific culture ToString(String, IFormatProvider)

반환 값은 PositiveInfinitySymbolNegativeInfinitySymbol NaNSymbol 지정 된 대로,, 또는 현재 인스턴스의 값에 대 한 문자열 표현이 될 수 있습니다 format .The return value can be PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, or the string representation of the value of the current instance, as specified by format.

format매개 변수는 D와 X를 제외한 모든 유효한 표준 숫자 형식 지정자와 사용자 지정 숫자 형식 지정자의 조합을 사용할 수 있습니다.The format parameter can be any valid standard numeric format specifier except for D and X, as well as any combination of custom numeric format specifiers. Format이 null 또는 빈 문자열인 경우 반환 값의 형식은 일반 숫자 서식 지정자 ("G")로 지정 됩니다.If format is null or an empty string, the return value is formatted with the general numeric format specifier ("G").

.NET Framework는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다.The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

기본적으로 반환 값의 전체 자릿수는 7 자리 이지만 최대 9 자리는 내부적으로 유지 됩니다.By default, the return value only contains 7 digits of precision although a maximum of 9 digits is maintained internally. 이 인스턴스의 값이 7 자리 보다 큰 경우는 ToString(String) PositiveInfinitySymbol NegativeInfinitySymbol 예상 된 수 대신 또는를 반환 합니다.If the value of this instance has greater than 7 digits, ToString(String) returns PositiveInfinitySymbol or NegativeInfinitySymbol instead of the expected number. 더 많은 전체 자릿수가 필요한 경우에는 format 항상 9 자리 전체 자릿수를 반환 하는 "G9" 형식 지정을 사용 하 여을 지정 하 고, 숫자를 최대 전체 자릿수로 표현할 수 있는 경우 숫자를 해당 전체 자릿수 또는 9 자리로 표현할 수 있는 경우 7 자리를 반환 하는 "R"로 지정 합니다.If you require more precision, specify format with the "G9" format specification, which always returns 9 digits of precision, or "R", which returns 7 digits if the number can be represented with that precision or 9 digits if the number can only be represented with maximum precision.

추가 정보

적용 대상

ToString(IFormatProvider)

지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

매개 변수

provider
IFormatProvider

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

반환

String

이 인스턴스의 값을 provider에 지정된 내용에 따라 나타낸 문자열 표현입니다.The string representation of the value of this instance as specified by provider.

구현

예제

다음 예제에서는 Single CultureInfo 여러 가지 다른 문화권을 나타내는 개체를 사용 하 여 두 값의 문자열 표현을 표시 합니다.The following example displays the string representation of two Single values using CultureInfo objects that represent several different cultures.

float value;

value = -16325.62015F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));

value = 16034.125E21F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25
Dim value As Single 

value = -16325.62015
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))

value = 16034.125E21
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325.62015
'       -16325.62015
'       -16325,62015
'       1.6034125E+25
'       1.6034125E+25
'       1,6034125E+25

설명

ToString(IFormatProvider)메서드는 Single 지정 된 문화권의 기본값 ("G" 또는 일반) 형식으로 값의 형식을 지정 합니다.The ToString(IFormatProvider) method formats a Single value in the default ("G", or general) format of a specified culture. 다른 형식이 나 현재 문화권을 지정 하려면 다음과 같이 메서드의 다른 오버 로드를 사용 합니다 ToString .If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권의 경우For culture 오버 로드 사용Use the overload
기본 ("G") 형식Default ("G") format 기본 (현재) 문화권Default (current) culture ToString()
특정 형식A specific format 기본 (현재) 문화권Default (current) culture ToString(String)
특정 형식A specific format 특정 문화권A specific culture ToString(String, IFormatProvider)

반환 값은,, PositiveInfinitySymbol NegativeInfinitySymbol NaNSymbol 또는 형식의 문자열일 수 있습니다.The return value can be PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, or a string of the form:

[sign] 정수 계열 자릿수 [. [ 소수 자릿수]] [e [sign] 지 수-숫자][sign]integral-digits[.[fractional-digits]][e[sign]exponential-digits]

선택적 요소는 대괄호 ([및])로 묶여 있습니다.Optional elements are framed in square brackets ([ and ]). "Digits" 라는 용어를 포함 하는 요소는 0에서 9 사이의 일련의 숫자로 구성 됩니다.Elements containing the term "digits" consist of a series of numeric characters ranging from 0 to 9. 다음 표에서는 각 요소를 보여 줍니다.The following table lists each element.

요소Element DescriptionDescription
signsign 음수 기호 또는 양수 기호 기호입니다.A negative sign or positive sign symbol.
정수 자릿수integral-digits 숫자의 정수 부분을 지정 하는 일련의 숫자입니다.A series of digits specifying the integral part of the number. 소수 자릿수가 있으면 정수 부분을 지정할 수 없습니다.Integral-digits can be absent if there are fractional-digits.
'.''.' 문화권별 소수점 기호입니다.A culture-specific decimal point symbol.
소수 자릿수fractional-digits 숫자의 소수 부분을 지정 하는 일련의 숫자입니다.A series of digits specifying the fractional part of the number.
우표'e' 지 수 (과학적) 표기법을 나타내는 소문자 ' e '입니다.A lowercase character 'e', indicating exponential (scientific) notation.
지 수-자릿수exponential-digits 지 수를 지정 하는 일련의 숫자입니다.A series of digits specifying an exponent.

반환 값의 몇 가지 예는 "100", "-123456789", "123.45 e + 6", "500", "3.1416", "600", "-0.123" 및 "-Infinity"입니다.Some examples of the return value are "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123", and "-Infinity".

.NET Framework는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다.The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider매개 변수는 해당 IFormatProvider GetFormat 메서드가 개체를 반환 하는 구현입니다 NumberFormatInfo .The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object. 일반적으로 providerCultureInfo 개체 또는 NumberFormatInfo 개체입니다.Typically, provider is a CultureInfo object or a NumberFormatInfo object. provider매개 변수는 서식 지정에 사용 되는 문화권별 정보를 제공 합니다.The provider parameter supplies culture-specific information used in formatting. provider가 이면 null NumberFormatInfo 현재 문화권에 대 한 데이터를 사용 하 여 반환 값의 형식이 지정 됩니다.If provider is null, the return value is formatted using the NumberFormatInfo data for the current culture.

Single지정 된 문화권과 특정 형식 문자열을 사용 하 여 값을 문자열 표현으로 변환 하려면 메서드를 호출 Single.ToString(String, IFormatProvider) 합니다.To convert a Single value to its string representation using a specified culture and a specific format string, call the Single.ToString(String, IFormatProvider) method.

추가 정보

적용 대상

ToString()

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

반환

String

이 인스턴스 값의 문자열 표현입니다.The string representation of the value of this instance.

예제

다음 예제에서는 기본 메서드를 사용 하 여 Single.ToString 여러 값의 문자열 표현을 표시 합니다 Single .The following example uses the default Single.ToString method to display the string representations of a number of Single values.

float number;

number = 1.6E20F;
// Displays 1.6E+20.
Console.WriteLine(number.ToString());

number = 1.6E2F;
// Displays 160.
Console.WriteLine(number.ToString());

number = -3.541F;
// Displays -3.541.
Console.WriteLine(number.ToString());

number = -1502345222199E-07F;
// Displays -150234.5222199.
Console.WriteLine(number.ToString());

number = -15023452221990199574E-09F;
// Displays -15023452221.9902.
Console.WriteLine(number.ToString());

number = .60344F;
// Displays 0.60344.
Console.WriteLine(number.ToString());

number = .000000001F;
// Displays 1E-09.
Console.WriteLine(number.ToString());
Dim number As Single

number = 1.6E20
' Displays 1.6E+20.      
Console.WriteLine(number.ToString())

number = 1.6E2
' Displays 160.
Console.WriteLine(number.ToString())

number = -3.541
' Displays -3.541.
Console.WriteLine(number.ToString())

number = -1502345222199E-07
' Displays -150234.5222199.
Console.WriteLine(number.ToString())

number = -15023452221990199574E-09
' Displays -15023452221.9902.
Console.WriteLine(number.ToString())

number = .60344
' Displays 0.60344.
Console.WriteLine(number.ToString())

number = .000000001
' Displays 1E-09.
Console.WriteLine(number.ToString())

다음 코드 예제에서는 메서드와 함께 메서드를 사용 하는 방법을 보여 줍니다 Parse(String) ToString() .The following code example illustrates the use of the Parse(String) method along with the ToString() method.

bool done = false;
String^ inp;
do
{
   Console::Write( "Enter a real number: " );
   inp = Console::ReadLine();
   try
   {
      s = Single::Parse( inp );
      Console::WriteLine( "You entered {0}.", s );
      done = true;
   }
   catch ( FormatException^ ) 
   {
      Console::WriteLine( "You did not enter a number." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "An exception occurred while parsing your response: {0}", e );
   }
}
while (  !done );
bool done = false;
string inp;
do
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try
    {
        s = Single.Parse(inp);
        Console.WriteLine("You entered {0}.", s.ToString());
        done = true;
    }
    catch (FormatException)
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e)
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);
Dim Done As Boolean = False
Dim Inp As String
Do

    Console.Write("Enter a real number: ")
    Inp = Console.ReadLine()
    Try
        S = Single.Parse(Inp)
        Console.WriteLine("You entered " + S.ToString() + ".")
        Done = True
    Catch E As FormatException
        Console.WriteLine("You did not enter a number.")
    Catch E As Exception
        Console.WriteLine("An exception occurred while parsing your response: " + E.ToString())
    End Try
Loop While Not Done

설명

ToString()메서드는 Single 현재 문화권의 기본값 ("G" 또는 일반) 형식으로 값의 형식을 지정 합니다.The ToString() method formats a Single value in the default ("G", or general) format of the current culture. 다른 형식 또는 문화권을 지정 하려면 다음과 같이 메서드의 다른 오버 로드를 사용 합니다 ToString .If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권의 경우For culture 오버 로드 사용Use the overload
기본 ("G") 형식Default ("G") format 특정 문화권A specific culture ToString(IFormatProvider)
특정 형식A specific format 기본 (현재) 문화권Default (current) culture ToString(String)
특정 형식A specific format 특정 문화권A specific culture ToString(String, IFormatProvider)

반환 값은,, PositiveInfinitySymbol NegativeInfinitySymbol NaNSymbol 또는 형식의 문자열일 수 있습니다.The return value can be PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, or a string of the form:

[sign] 정수 계열 자릿수 [. [ 소수 자릿수]] [e [sign] 지 수-숫자][sign]integral-digits[.[fractional-digits]][e[sign]exponential-digits]

선택적 요소는 대괄호 ([및])로 묶여 있습니다.Optional elements are framed in square brackets ([ and ]). "Digits" 라는 용어를 포함 하는 요소는 0에서 9 사이의 일련의 숫자로 구성 됩니다.Elements that contain the term "digits" consist of a series of numeric characters ranging from 0 to 9. 다음 표에서는 각 요소를 보여 줍니다.The following table lists each element:

요소Element DescriptionDescription
signsign 음수 기호 또는 양수 기호 기호입니다.A negative sign or positive sign symbol.
정수 자릿수integral-digits 숫자의 정수 부분을 지정 하는 일련의 숫자입니다.A series of digits specifying the integral part of the number. 소수 자릿수가 있으면 정수 부분을 지정할 수 없습니다.Integral-digits can be absent if there are fractional-digits.
'.''.' 문화권별 소수점 기호입니다.A culture-specific decimal point symbol.
소수 자릿수fractional-digits 숫자의 소수 부분을 지정 하는 일련의 숫자입니다.A series of digits specifying the fractional part of the number.
우표'e' 지 수 (과학적) 표기법을 나타내는 소문자 ' e '입니다.A lowercase character 'e', indicating exponential (scientific) notation.
지 수-자릿수exponential-digits 지 수를 지정 하는 일련의 숫자입니다.A series of digits specifying an exponent.

반환 값의 몇 가지 예는 "100", "-123456789", "123.45 e + 6", "500", "3.1416", "600", "-0.123" 및 "-Infinity"입니다.Some examples of the return value are "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123", and "-Infinity".

.NET Framework는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다.The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

추가 정보

적용 대상