Int16.ToString 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將這個執行個體的數值轉換為其相等字串表示。

多載

ToString()	將這個執行個體的數值轉換為其相等字串表示。
ToString(IFormatProvider)	使用指定的特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String)	使用指定格式，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String, IFormatProvider)	使用指定的格式和文化特性特定的格式資訊，將這個執行個體的數值轉換成它的對等字串表示。

ToString()

來源:: Int16.cs

來源:: Int16.cs

來源:: 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()使用NumberFormatInfo目前文化特性的物件，將預設 (“G” 或一般) 格式的值格式化Int16。如果您要指定不同的格式或文化特性，請使用方法的其他多載 ToString ，如下所示：

若要使用格式	針對文化特性	使用多載
默認 (“G”) 格式	特定文化特性	ToString(IFormatProvider)
特定格式	默認 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

.NET 提供廣泛的格式設定支援，在下列格式設定主題中會更詳細地說明：

如需數值格式規範的詳細資訊，請參閱標準數值格式字串和自定義數值格式字串。
如需格式化的詳細資訊，請參閱格式化類型。

另請參閱

適用於

ToString(IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: 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)使用NumberFormatInfo指定文化特性的物件，將預設 (“G” 或一般) 格式的值格式化Int16。如果您要指定不同的格式或目前的文化特性，請使用方法的其他多載 ToString ，如下所示：

若要使用格式	針對文化特性	使用多載
默認 (“G”) 格式	默認 (目前) 文化特性	ToString()
特定格式	默認 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

.NET 提供廣泛的格式設定支援，在下列格式設定主題中會更詳細地說明：

如需數值格式規範的詳細資訊，請參閱標準數值格式字串和自定義數值格式字串。
如需格式化的詳細資訊，請參閱格式化類型。

參數provider是IFormatProvider實作，其方法會NumberFormatInfo傳IFormatProvider.GetFormat回物件。一般而言， provider 是 NumberFormatInfo 對象或 CultureInfo 物件。物件 NumberFormatInfo 提供這個方法所傳回之字串格式的文化特性特定資訊。如果 provider 為 null，這個實例會格式化 NumberFormatInfo 為目前文化特性的物件。

另請參閱

適用於

ToString(String)

來源:: Int16.cs

來源:: Int16.cs

來源:: 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)

來源:: Int16.cs

來源:: Int16.cs

來源:: 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)使用NumberFormatInfo指定文化特性的物件，以指定的格式格式化Int16值。如果您想要使用預設格式或文化特性設定，請使用方法的其他多載 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)

參數

傳回

實作

範例

備註

另請參閱

適用於

其他資源