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:
 virtual 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

カルチャ固有の書式情報を提供する IFormatProviderAn 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. 場合providernullのこのインスタンスは書式設定、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.

戻り値

format および provider で指定された、このインスタンスの値の文字列形式。The string representation of the value of this instance as specified by format and provider.

実装

次の例では、表示、Int16で 4 つの異なるカルチャを使用して、サポートされている標準書式指定文字列の各値します。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:

  • ACultureInfo書式指定規則を使用するカルチャを表すオブジェクト。A CultureInfo object that represents the culture whose formatting rules are to be used.

  • ANumberFormatInfoこの値の特定の数値書式設定情報を格納しているオブジェクト。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) 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.

次の例では、2 つを初期化します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 までの一連の数字から構成される、このインスタンスの値の文字列形式。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:

こちらもご覧ください

適用対象