Int16.ToString 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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 -> stringPublic Overrides Function ToString () As 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 -> stringPublic Function ToString (provider As IFormatProvider) As String參數
- provider
- IFormatProvider
IFormatProvider，提供特定文化特性的格式資訊。
傳回
這個執行個體值的字串表示，如同 provider 所指定。
實作
範例
下列範例會逐一查看值數位， 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 -> stringPublic Function ToString (format As String) As String參數
- format
- 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 -> stringPublic Function ToString (format As String, provider As IFormatProvider) As String參數
- format
- String
數值格式字串。
- provider
- IFormatProvider
物件，提供特定文化特性格式資訊。
傳回
這個執行個體值的字串表示，如同 format 和 provider 所指定。
實作
範例
下列範例會以四個不同的文化特性，使用每個支援的標準格式字串來顯示 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 目前文化特性的 格式化。
另請參閱
- Parse(String)
- 在 .NET 中將類型格式化
- 標準數值格式字串
- Custom Numeric Format Strings
- 作法：以前置字元零來填補數字
- Sample: .NET Core WinForms Formatting Utility (C#) (範例：.NET Core WinForms 格式化公用程式 (C#))
- Sample: .NET Core WinForms Formatting Utility (Visual Basic) (範例：.NET Core WinForms 格式化公用程式 (Visual Basic))
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應