Int16.ToString 메서드

정의

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

오버로드

ToString(IFormatProvider)

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

ToString(String, IFormatProvider)

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

ToString(String)

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

ToString()

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

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

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

반환

String

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

구현

예제

다음 예제에서는 Int16 Int16.ToString(IFormatProvider) 다양 한 형식 공급자를 사용 하 여 메서드를 호출 하 여 값의 배열을 반복 하 고 각 값을 콘솔에 표시 합니다.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. 기본 "G" 서식 지정자로 정의 되는 간단한 서식 지정 때문에 각 값에 대해 생성 된 형식이 지정 된 문자열은 Int16 매개 변수의 값에 관계 없이 동일 합니다 provider .Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ",
                    int16Value.ToString(provider),
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      

설명

ToString(IFormatProvider)메서드는 지정 된 Int16 문화권의 개체를 사용 하 여 기본값 ("G" 또는 일반) 형식으로 값의 서식을 NumberFormatInfo 지정 합니다.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object 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)

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

provider매개 변수는 해당 IFormatProvider IFormatProvider.GetFormat 메서드가 개체를 반환 하는 구현입니다 NumberFormatInfo .The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. 일반적으로 providerNumberFormatInfo 개체 또는 CultureInfo 개체입니다.Typically, provider is a NumberFormatInfo object or a CultureInfo object. NumberFormatInfo개체는이 메서드에서 반환 하는 문자열의 형식에 대 한 문화권별 정보를 제공 합니다.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. provider가 이면 null 이 인스턴스는 NumberFormatInfo 현재 문화권에 대 한 개체를 사용 하 여 형식이 지정 됩니다.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

추가 정보

적용 대상

ToString(String, IFormatProvider)

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

구현

예제

다음 예제에서는 네 가지 Int16 문화권에서 지원 되는 각 표준 형식 문자열을 사용 하 여 값을 표시 합니다.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ",
                    value.ToString(format, provider));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €
//    D6                014603        014603        014603        014603
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004
//    F1               14603.0       14603,0       14603,0       14603,0
//    G                  14603         14603         14603         14603
//    N1              14,603.0      14 603,0      14.603,0      14.603,0
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %
//    X4                  390B          390B          390B          390B
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000
//    ##000.0          14603.0       14603,0       14603,0       14603,0
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0  

설명

ToString(String, IFormatProvider)메서드는 지정 된 Int16 문화권의 개체를 사용 하 여 지정 된 형식의 값에 서식을 지정 합니다 NumberFormatInfo .The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object 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)

format매개 변수는 표준 또는 사용자 지정 숫자 서식 문자열 중 하나일 수 있습니다.The format parameter can be either a standard or a custom numeric format string. "R" (또는 "r") 이외의 모든 표준 숫자 서식 문자열은 모든 사용자 지정 숫자 형식 문자 처럼 지원 됩니다.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. format null 이 이거나 빈 문자열 ("") 인 경우이 메서드에서 반환 되는 문자열의 형식은 일반 숫자 서식 지정자 ("G")로 지정 됩니다.If format is null or an empty string (""), the string returned by this method 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 구현입니다.The provider parameter is an IFormatProvider implementation. 해당 GetFormat 메서드는 NumberFormatInfo 이 메서드가 반환 하는 문자열의 형식에 대 한 문화권별 정보를 제공 하는 개체를 반환 합니다.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. 을 구현 하는 개체는 IFormatProvider 다음 중 하나일 수 있습니다.The object that implements IFormatProvider can be any of the following:

  • CultureInfo사용할 형식 지정 규칙의 문화권을 나타내는 개체입니다.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo이 값에 대 한 특정 숫자 서식 지정 정보를 포함 하는 개체입니다.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • 을 구현 하는 사용자 지정 개체 IFormatProvider 입니다.A custom object that implements IFormatProvider.

providernull 이거나 NumberFormatInfo 에서 개체를 가져올 수 없는 경우 provider 반환 값은 현재 문화권의로 형식이 지정 됩니다 NumberFormatInfo .If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for the current culture.

추가 정보

적용 대상

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.

예제

다음 예제에서는 두 값을 초기화 Int16 하 고 지원 되는 각 표준 형식 문자열과 여러 사용자 지정 형식 문자열을 사용 하 여 콘솔에 표시 합니다.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. 이 예제는 현재 문화권으로 en-us로 실행 됩니다.The example is run with en-US as the current culture.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",
                     format,
                     values[0].ToString(format),
                     values[1].ToString(format));
}
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0      

설명

ToString(String)메서드는 Int16 NumberFormatInfo 현재 문화권의 규칙을 나타내는 개체를 사용 하 여 지정 된 형식의 값에 서식을 지정 합니다.The ToString(String) method formats an Int16 value in a specified format by using a NumberFormatInfo object that represents 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)

format매개 변수는 표준 또는 사용자 지정 숫자 서식 문자열 중 하나일 수 있습니다.The format parameter can be either a standard or a custom numeric format string. "R" (또는 "r") 이외의 모든 표준 숫자 서식 문자열은 모든 사용자 지정 숫자 형식 문자 처럼 지원 됩니다.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. format null 이 또는 빈 문자열인 경우이 인스턴스의 반환 값은 일반 숫자 형식 지정자 ("G")로 형식이 지정 됩니다.If format is null or an empty string, the return value of 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:

이 인스턴스의 반환 값은 현재 문화권의로 형식이 지정 됩니다 NumberFormatInfo .The return value of this instance is formatted with the NumberFormatInfo for the current culture.

추가 정보

적용 대상

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

음수 부호(값이 음수일 경우)와 0부터 9 사이의 숫자(앞에 오는 0은 사용하지 않음)들로 구성된 이 인스턴스의 값에 대한 문자열 표현입니다.The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

예제

다음 예제에서는 메서드를 사용 하 여 ToString() 콘솔에 값의 배열을 표시 합니다 Int16 .The following example uses the ToString() method to display an array of Int16 values to the console.

short[] numbers = {0, 14624, 13982, short.MaxValue,
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667                             

설명

ToString()메서드는 Int16 NumberFormatInfo 현재 문화권의 개체를 사용 하 여 기본값 ("G" 또는 일반) 형식으로 값의 형식을 지정 합니다.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object 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)

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

추가 정보

적용 대상