Int16.ToString Int16.ToString Int16.ToString Int16.ToString Method

정의

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

오버로드

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

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

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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) ToString(String) ToString(String) ToString(String)

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

ToString() ToString() ToString() ToString()

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

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

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

public:
 System::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 IFormatProvider IFormatProvider

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

반환

이 인스턴스의 값을 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. 일반적으로 provider 되는 NumberFormatInfo 개체 또는 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) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

매개 변수

format
String String String String

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

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. 경우 formatnull 또는 빈 문자열 (""),이 메서드에서 반환 된 문자열의 일반 숫자 서식 지정자 ("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.

경우 provider 됩니다 null, 또는 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) ToString(String) ToString(String) 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);
override this.ToString : string -> string
Public Function ToString (format As String) As String

매개 변수

format
String String String String

숫자 서식 문자열입니다.A numeric format 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. 하는 경우 formatnull 이거나 빈 문자열인 경우 반환 값이 인스턴스의 일반 숫자 서식 지정자 ("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() ToString() ToString() 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

반환

음수 부호(값이 음수일 경우)와 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 값 ("G" 또는 일반) 기본 형식을 사용 하 여를 NumberFormatInfo 현재 문화권의 개체입니다.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:

추가 정보

적용 대상