Int16.ToString 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将此实例的数值转换为其等效的字符串表示形式。

重载

ToString()	将此实例的数值转换为其等效的字符串表示形式。
ToString(IFormatProvider)	使用指定的区域性特定格式信息，将此实例的数值转换为它的等效字符串表示形式。
ToString(String)	使用指定的格式，将此实例的数值转换为它的等效字符串表示形式。
ToString(String, IFormatProvider)	使用指定的格式和区域性特定格式设置信息，将此实例的数值转换为其等效字符串表示形式。

ToString()

Source:: Int16.cs

Source:: Int16.cs

Source:: Int16.cs

将此实例的数值转换为其等效的字符串表示形式。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

String

此实例的值的字符串表示形式，由减号（如果值为负）和范围从 0 到 9 且没有前导零的数字序列组成。

示例

以下示例使用 ToString() 方法向控制台显示值数组 Int16 。

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

let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]

for number in numbers do
    printfn $"{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”或常规) 格式的值。如果要指定不同的格式或区域性，请使用方法的其他重载 ToString ，如下所示：

使用格式	对于区域性	使用重载
默认 (“G”) 格式	特定区域性	ToString(IFormatProvider)
特定格式	默认 (当前) 区域性	ToString(String)
特定格式	特定区域性	ToString(String, IFormatProvider)

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数值格式字符串。
有关格式设置的详细信息，请参阅格式设置类型。

另请参阅

适用于

ToString(IFormatProvider)

Source:: Int16.cs

Source:: Int16.cs

Source:: Int16.cs

使用指定的区域性特定格式信息，将此实例的数值转换为它的等效字符串表示形式。

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，它提供区域性特定的格式设置信息。

String

此实例的值的字符串表示形式，由 provider 指定。

实现

ToString(IFormatProvider)

示例

以下示例循环访问一个值数组 Int16 ，并通过使用不同的格式提供程序调用 Int16.ToString(IFormatProvider) 方法，将每个值显示到控制台。由于默认“G”格式说明符定义的简单格式，因此无论参数的值provider如何，为每个Int16值生成的格式化字符串都是相同的。

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)

let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for int16Value in numbers do
    for provider in providers do
        printf $"{int16Value.ToString provider, 6} ({provider.Name})     "
                    
    printfn ""

// 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”或常规) 格式的值的格式。如果要指定其他格式或当前区域性，请使用方法的其他重载 ToString ，如下所示：

使用格式	对于区域性	使用重载
默认 (“G”) 格式	默认 (当前) 区域性	ToString()
特定格式	默认 (当前) 区域性	ToString(String)
特定格式	特定区域性	ToString(String, IFormatProvider)

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数值格式字符串。
有关格式设置的详细信息，请参阅格式设置类型。

provider参数是其IFormatProvider方法返回 NumberFormatInfo 对象的实现IFormatProvider.GetFormat。通常， provider 是对象 NumberFormatInfo 或 CultureInfo 对象。对象 NumberFormatInfo 提供有关此方法返回的字符串格式的区域性特定信息。如果 provider 为 null，则使用当前区域性的对象设置 NumberFormatInfo 此实例的格式。

另请参阅

适用于

ToString(String)

Source:: Int16.cs

Source:: Int16.cs

Source:: Int16.cs

使用指定的格式，将此实例的数值转换为它的等效字符串表示形式。

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

一个数值格式字符串。

String

此实例的值的字符串表示形式，由 format 指定。

示例

以下示例初始化两个 Int16 值，并使用每个受支持的标准格式字符串和多个自定义格式字符串将它们显示到控制台。该示例以 en-US 作为当前区域性运行。

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

let values = [| -23805s; 32194s |]
let formats = 
    [ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
    printfn $"'{format,2}' format specifier: {values[0].ToString format,17}   {values[1].ToString format,17}"

// 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表示当前区域性约定的对象，以指定格式设置值的格式。如果要使用默认 (“G”或常规) 格式或指定其他区域性，请使用方法的其他重载 ToString ，如下所示：

使用格式	对于区域性	使用重载
默认 (“G”) 格式	默认 (当前) 区域性	ToString()
默认 (“G”) 格式	特定区域性	ToString(IFormatProvider)
特定格式	特定区域性	ToString(String, IFormatProvider)

参数 format 可以是标准或自定义数字格式字符串。支持除“R” (或“r”) 以外的所有标准数字格式字符串，以及所有自定义数字格式字符。如果 format 为 null 或空字符串，则此实例的返回值使用常规数值格式说明符 (“G”) 进行格式化。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数值格式字符串。
有关格式设置的详细信息，请参阅格式设置类型。

对于当前区域性，此实例的返回值的格式为 NumberFormatInfo 。

另请参阅

适用于

ToString(String, IFormatProvider)

Source:: Int16.cs

Source:: Int16.cs

Source:: Int16.cs

使用指定的格式和区域性特定格式设置信息，将此实例的数值转换为其等效字符串表示形式。

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

一个数值格式字符串。

provider: IFormatProvider

一个提供区域性特定的格式设置信息的对象。

String

此实例的值的字符串表示形式，由 format 和 provider 指定。

实现

ToString(String, IFormatProvider)

示例

以下示例使用四个不同区域性中每个受支持的标准格式字符串显示一个 Int16 值。

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

 let value = 14603
 let formats =
     [ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
       "P0"; "X4"; "000000.0000"; "##000.0" ]
 let providers = 
     [ CultureInfo "en-us"
       CultureInfo "fr-fr"
       CultureInfo "de-de"
       CultureInfo "es-es" ]
 // Display header.
 printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
 
 // Display a value using each format string.
 for format in formats do
     // Display the value for each provider on the same line.
     printf $"{format,-12}"
     for provider in providers do
         printf $"{value.ToString(format, provider),12}  "
     printfn ""

// 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指定区域性的对象以指定格式设置值的格式。如果要使用默认格式或区域性设置，请使用方法的其他重载 ToString ，如下所示：

使用格式	对于区域性	使用重载
默认 (“G”) 格式	默认 (当前) 区域性	ToString()
默认 (“G”) 格式	特定区域性	ToString(IFormatProvider)
特定格式	默认 (当前) 区域性	ToString(String)

参数 format 可以是标准或自定义数字格式字符串。支持除“R” (或“r”) 以外的所有标准数字格式字符串，以及所有自定义数字格式字符。如果 format 为 null 或空字符串 (“”) ，则此方法返回的字符串使用常规数值格式说明符 (“G”) 进行格式化。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数值格式字符串。
有关格式设置的详细信息，请参阅格式设置类型。

参数 provider 是实现 IFormatProvider 。其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关此方法返回的字符串格式的区域性特定信息。实现的对象 IFormatProvider 可以是以下任一项：

一个 CultureInfo 对象，表示要使用其格式规则的区域性。
一个 NumberFormatInfo 对象，其中包含此值的特定数值格式设置信息。
实现的 IFormatProvider自定义对象。

如果 provider 为 null，或者 NumberFormatInfo 无法从 provider获取对象，则返回值使用当前区域性的格式化 NumberFormatInfo 。

另请参阅

适用于

通过

Int16.ToString 方法

定义

重载

ToString()

返回

示例

注解

另请参阅

适用于

ToString(IFormatProvider)

参数

返回

实现

示例

注解

另请参阅

适用于

ToString(String)

参数

返回

示例

注解

另请参阅

适用于

ToString(String, IFormatProvider)

参数

返回

实现

示例

注解

另请参阅

适用于

其他资源