Int16.ToString 方法

定義

命名空間:: System

組件:: mscorlib.dll, System.Runtime.dll

組件:: netstandard.dll, System.Runtime.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

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

將這個實例的數值轉換為其相等的字串表示。

多載

名稱	Description
ToString()	將這個實例的數值轉換為其相等的字串表示。
ToString(IFormatProvider)	利用指定的文化特定格式資訊，將此實例的數值轉換為其等效字串表示。
ToString(String)	使用指定的格式，將這個實例的數值轉換為其相等的字串表示。
ToString(String, IFormatProvider)	利用指定的格式及文化特有格式資訊，將此實例的數值轉換為等效字串表示。

ToString()

來源:: Int16.cs

來源:: Int16.cs

來源:: 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()方法透過使用Int16當前文化的物件，將NumberFormatInfo值格式化為預設（「G」或一般格式）。如果你想指定不同的格式或文化，請使用方法的其他超載 ToString ，如下：

使用格式	為了文化	利用過載
預設（「G」）格式	特定文化	ToString(IFormatProvider)
特定格式	預設（現行）文化	ToString(String)
特定格式	特定文化	ToString(String, IFormatProvider)

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

欲了解更多關於數值格式指定符的資訊，請參閱標準數值格式字串與自訂數值格式字串。
欲了解更多格式相關資訊，請參閱格式類型。

另請參閱

適用於

ToString(IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: 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」格式規範符定義的簡單格式，每個值產生 Int16 的格式字串無論參數值為 provider 何皆相同。

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 實作，其 IFormatProvider.GetFormat 方法回傳一個 NumberFormatInfo 物件。通常， provider 是一個 NumberFormatInfo 物件或一個 CultureInfo 物件。物件 NumberFormatInfo 提供此方法回傳字串格式的文化特定資訊。若 provider 是 null，則此實例格式化為 NumberFormatInfo 當前文化的物件。

另請參閱

適用於

ToString(String)

來源:: Int16.cs

來源:: Int16.cs

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

來源:: 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)方法透過使用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當前文化的。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？