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

カルチャ固有の書式情報を提供する 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されたカルチャのNumberFormatInfoオブジェクトを使用して、既定の ("G" または "general") 形式の値を書式設定します。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:

パラメーターは、 IFormatProvider.GetFormatメソッドがオブジェクトをNumberFormatInfo返す実装です。IFormatProvider providerThe 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 NumberFormatInfoの場合、このインスタンスは現在のカルチャのオブジェクトを使用して書式設定されます。 nullIf 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);
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.

戻り値

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. このメソッドは、 NumberFormatInfoこのメソッドによって返される文字列の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。 GetFormatIts 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:

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

  • この値の特定の数値書式情報を格納しているオブジェクト。NumberFormatInfoA NumberFormatInfo object that contains specific numeric formatting information for this value.

  • を実装IFormatProviderするカスタムオブジェクト。A custom object that implements IFormatProvider.

provider NumberFormatInfo providerの場合、またはからオブジェクトを取得できない場合、戻り値は現在NumberFormatInfoのカルチャので書式設定されます。 nullIf 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);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String

数値書式指定文字列。A numeric format string.

戻り値

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

次の例ではInt16 、2つの値を初期化し、サポートされている標準書式指定文字列といくつかのカスタム書式指定文字列を使用してコンソールに表示します。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()

このインスタンスの数値を、それと等価な文字列形式に変換します。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のカルチャのNumberFormatInfoオブジェクトを使用して、既定の ("G" または "general") 形式の値を書式設定します。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:

こちらもご覧ください

適用対象