Int64.ToString 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將這個實例的數值轉換為其相等的字串表示。
多載
ToString(IFormatProvider) |
使用指定的特定文化特性格式資訊,將這個實例的數值轉換為其相等的字串表示。 |
ToString() |
將這個實例的數值轉換為其相等的字串表示。 |
ToString(String) |
使用指定的格式,將這個實例的數值轉換為其相等的字串表示。 |
ToString(String, IFormatProvider) |
使用指定的格式和文化特性特定格式資訊,將這個實例的數值轉換為其相等的字串表示。 |
ToString(IFormatProvider)
- 來源:
- Int64.cs
- 來源:
- Int64.cs
- 來源:
- Int64.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。
傳回
這個實例值的字串表示,如 provider
所指定。
實作
範例
下列範例會使用代表數個不同文化特性的 CultureInfo 對象,顯示 Int64 值的字串表示。
long value = -16325901;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
// -16325901
// -16325901
// -16325901
let value = -16325901L
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB" )}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE" )}"""
// This example displays the following output to the console:
// -16325901
// -16325901
// -16325901
Dim value As Long = -16325801
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
' -16325901
' -16325901
' -16325901
備註
ToString(IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件,以預設 (“G” 或一般) 格式格式化 Int64 值。 如果您想要指定不同的格式或目前的文化特性,請使用 ToString 方法的其他多載,如下所示:
使用格式 | 針對文化特性 | 使用多載 |
---|---|---|
預設值 (“G”) 格式 | 預設 (目前) 文化特性 | ToString() |
特定格式 | 預設 (目前) 文化特性 | ToString(String) |
特定格式 | 特定文化特性 | ToString(String, IFormatProvider) |
provider
參數是實作 IFormatProvider 介面的物件。 其 GetFormat 方法會傳回 NumberFormatInfo 物件,提供這個方法所傳回之字串格式的文化特性特定資訊。 實作 IFormatProvider 的物件可以是下列任一項:
CultureInfo 物件,表示要使用的格式化規則文化特性。
NumberFormatInfo 物件,其中包含這個值的特定數值格式資訊。
實作 IFormatProvider 的自定義物件,其 GetFormat 方法會傳回提供格式資訊的 NumberFormatInfo 物件。
如果 provider
null
或無法從 provider
取得 NumberFormatInfo 物件,則傳回值會以目前文化特性的 NumberFormatInfo 物件格式化。
.NET 提供廣泛的格式支援,如下列格式化主題中更詳細地說明:
另請參閱
- Parse(String)
- String
- .NET 中的格式設定類型
適用於
ToString()
- 來源:
- Int64.cs
- 來源:
- Int64.cs
- 來源:
- Int64.cs
將這個實例的數值轉換為其相等的字串表示。
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
傳回
這個實例值的字串表示,如果值為負數,則由減號組成,以及介於 0 到 9 之間的數位序列,不含前置零。
範例
下列範例會使用預設 ToString() 方法來顯示 Int64 值。 它也會顯示 Int64 值的字串表示,這些值是使用一些標準格式規範所產生。 這些範例會使用 en-US 文化特性的格式設定慣例來顯示。
long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -16325091
Console.WriteLine(value.ToString("C")); // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")); // Displays -16325091
Console.WriteLine(value.ToString("F")); // Displays -16325091.00
Console.WriteLine(value.ToString("N")); // Displays -16,325,091.00
Console.WriteLine(value.ToString("N0")); // Displays -16,325,091
Console.WriteLine(value.ToString("X")); // Displays FFFFFFFFFF06E61D
let value = -16325091L
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -16325091
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -16325091
printfn $"""{value.ToString "C"}""" // Displays ($16,325,091.00)
printfn $"""{value.ToString "D"}""" // Displays -16325091
printfn $"""{value.ToString "F"}""" // Displays -16325091.00
printfn $"""{value.ToString "N"}""" // Displays -16,325,091.00
printfn $"""{value.ToString "N0"}""" // Displays -16,325,091
printfn $"""{value.ToString "X"}""" // Displays FFFFFFFFFF06E61D
Dim value As Long = -16325091
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -16325091
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -16325091
Console.WriteLine(value.ToString("C")) ' Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")) ' Displays -16325091
Console.WriteLine(value.ToString("F")) ' Displays -16325091.00
Console.WriteLine(value.ToString("N")) ' Displays -16,325091.00
Console.WriteLine(value.ToString("X")) ' Displays FFFFFFFFFF06E61D
備註
ToString() 方法會使用目前文化特性的 NumberFormatInfo 物件,以預設 (“G” 或一般) 格式格式化 Int64 值。 如果您想要指定不同的格式或文化特性,請使用 ToString 方法的其他多載,如下所示:
使用格式 | 針對文化特性 | 使用多載 |
---|---|---|
預設值 (“G”) 格式 | 特定文化特性 | ToString(IFormatProvider) |
特定格式 | 預設 (目前) 文化特性 | ToString(String) |
特定格式 | 特定文化特性 | ToString(String, IFormatProvider) |
.NET 提供廣泛的格式支援,如下列格式化主題中更詳細地說明:
另請參閱
- Parse(String)
- String
- .NET 中的格式設定類型
適用於
ToString(String)
- 來源:
- Int64.cs
- 來源:
- Int64.cs
- 來源:
- Int64.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
數值格式字串。
傳回
這個實例值的字串表示,如 format
所指定。
例外狀況
format
無效或不受支援。
範例
下列範例會使用每個支援的標準數值格式規範,以及兩個自定義數值格式字串,顯示 Int64 值。 在將數值轉換成字串時,此範例會使用 en-US 文化特性的格式慣例。
long value = -16325;
string specifier;
// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000.0).ToString(specifier));
// Displays: P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: X: FFFFFFFFFFFFC03B
// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: 0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays: #,#.00#;(#,#.00#): 16,325.00
let value = -16325L
// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: G: -16325
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: C: ($16,325.00)
let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: D8: -00016325
let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: E4: -1.6325E+004
let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: e3: -1.633e+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: F: -16325.00
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier }"
// Displays: N: -16,325.00
let specifier = "P"
printfn $"{specifier}: {(float value / 100000.0).ToString specifier}"
// Displays: P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays: X: FFFFFFFFFFFFC03B
// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays: 0,0.000: -16,325.000
let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1L).ToString specifier}"
// Displays: #,#.00#(#,#.00#): 16,325.00
Dim value As Long = -16325
Dim specifier As String
' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays: P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: X: FFFFFFFFFFFFC03B
' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: 0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays: #,#.00#;(#,#.00#): 16,325.00
備註
ToString(String) 方法會使用代表目前文化特性慣例的 NumberFormatInfo 物件,以指定格式格式化 Int64 值。 如果您想要使用預設 (“G” 或一般) 格式或指定不同的文化特性,請使用 ToString 方法的其他多載,如下所示:
使用格式 | 針對文化特性 | 使用多載 |
---|---|---|
預設值 (“G”) 格式 | 預設 (目前) 文化特性 | ToString() |
預設值 (“G”) 格式 | 特定文化特性 | ToString(IFormatProvider) |
特定格式 | 特定文化特性 | ToString(String, IFormatProvider) |
format
參數可以是任何有效的標準數值格式規範,但 “R” 除外,以及自定義數值格式規範的任何組合。 如果 format
是 null
或空字串 (“),則這個實例的傳回值會以一般數值格式規範 (”G“ 格式化)。
.NET 提供廣泛的格式支援,如下列格式化主題中更詳細地說明:
這個實例的傳回值會以目前文化特性的 NumberFormatInfo 格式化。
另請參閱
- Parse(String)
- String
- .NET 中的格式設定類型
- 標準數值格式字串
- 自定義數值格式字串
- 如何:以前置零填補數位,
適用於
ToString(String, IFormatProvider)
- 來源:
- Int64.cs
- 來源:
- Int64.cs
- 來源:
- Int64.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
物件,提供這個實例的文化特性特定格式資訊。
傳回
這個實例值的字串表示,如 format
和 provider
所指定。
實作
例外狀況
format
無效或不受支援。
範例
下列範例會針對三個不同的文化特性,使用每個支援的標準數值格式規範,顯示正值和負值。
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "N0", "P", "X8"};
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
{
// Display values with "G" format specifier.
Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
specifier, culture.Name,
positiveNumber.ToString(specifier, culture),
negativeNumber.ToString(specifier, culture));
}
Console.WriteLine();
}
// The example displays the following output to the console:
// G format using en-US culture: 1679 -3045
// G format using fr-FR culture: 1679 -3045
// G format using es-ES culture: 1679 -3045
//
// C format using en-US culture: $1,679.00 ($3,045.00)
// C format using fr-FR culture: 1 679,00 € -3 045,00 €
// C format using es-ES culture: 1.679,00 € -3.045,00 €
//
// D8 format using en-US culture: 00001679 -00003045
// D8 format using fr-FR culture: 00001679 -00003045
// D8 format using es-ES culture: 00001679 -00003045
//
// E2 format using en-US culture: 1.68E+003 -3.05E+003
// E2 format using fr-FR culture: 1,68E+003 -3,05E+003
// E2 format using es-ES culture: 1,68E+003 -3,05E+003
//
// F format using en-US culture: 1679.00 -3045.00
// F format using fr-FR culture: 1679,00 -3045,00
// F format using es-ES culture: 1679,00 -3045,00
//
// N format using en-US culture: 1,679.00 -3,045.00
// N format using fr-FR culture: 1 679,00 -3 045,00
// N format using es-ES culture: 1.679,00 -3.045,00
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// P format using en-US culture: 167,900.00% -304,500.00%
// P format using fr-FR culture: 167 900,00 % -304 500,00 %
// P format using es-ES culture: 167.900,00 % -304.500,00 %
//
// X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
// Define cultures whose formatting conventions are to be used.
let cultures =
[| CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" |]
let positiveNumber = 1679L
let negativeNumber = -3045L
let specifiers = [| "G"; "C"; "D8"; "E2"; "F"; "N"; "N0"; "P"; "X8" |]
for specifier in specifiers do
for culture in cultures do
// Display values with "G" format specifier.
printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output to the console:
// G format using en-US culture: 1679 -3045
// G format using fr-FR culture: 1679 -3045
// G format using es-ES culture: 1679 -3045
//
// C format using en-US culture: $1,679.00 ($3,045.00)
// C format using fr-FR culture: 1 679,00 € -3 045,00 €
// C format using es-ES culture: 1.679,00 € -3.045,00 €
//
// D8 format using en-US culture: 00001679 -00003045
// D8 format using fr-FR culture: 00001679 -00003045
// D8 format using es-ES culture: 00001679 -00003045
//
// E2 format using en-US culture: 1.68E+003 -3.05E+003
// E2 format using fr-FR culture: 1,68E+003 -3,05E+003
// E2 format using es-ES culture: 1,68E+003 -3,05E+003
//
// F format using en-US culture: 1679.00 -3045.00
// F format using fr-FR culture: 1679,00 -3045,00
// F format using es-ES culture: 1679,00 -3045,00
//
// N format using en-US culture: 1,679.00 -3,045.00
// N format using fr-FR culture: 1 679,00 -3 045,00
// N format using es-ES culture: 1.679,00 -3.045,00
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// P format using en-US culture: 167,900.00% -304,500.00%
// P format using fr-FR culture: 167 900,00 % -304 500,00 %
// P format using es-ES culture: 167.900,00 % -304.500,00 %
//
// X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
' Define cultures whose formatting conventions are to be used.
Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
CultureInfo.CreateSpecificCulture("fr-FR"), _
CultureInfo.CreateSpecificCulture("es-ES") }
Dim positiveNumber As Long = 1679
Dim negativeNumber As Long = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
' Display values with "G" format specifier.
Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}", _
specifier, culture.Name, _
positiveNumber.ToString(specifier, culture), _
negativeNumber.ToString(specifier, culture))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
'
' G format using en-US culture: 1679 -3045
' G format using fr-FR culture: 1679 -3045
' G format using es-ES culture: 1679 -3045
'
' C format using en-US culture: $1,679.00 ($3,045.00)
' C format using fr-FR culture: 1 679,00 € -3 045,00 €
' C format using es-ES culture: 1.679,00 € -3.045,00 €
'
' D8 format using en-US culture: 00001679 -00003045
' D8 format using fr-FR culture: 00001679 -00003045
' D8 format using es-ES culture: 00001679 -00003045
'
' E2 format using en-US culture: 1.68E+003 -3.05E+003
' E2 format using fr-FR culture: 1,68E+003 -3,05E+003
' E2 format using es-ES culture: 1,68E+003 -3,05E+003
'
' F format using en-US culture: 1679.00 -3045.00
' F format using fr-FR culture: 1679,00 -3045,00
' F format using es-ES culture: 1679,00 -3045,00
'
' N format using en-US culture: 1,679.00 -3,045.00
' N format using fr-FR culture: 1 679,00 -3 045,00
' N format using es-ES culture: 1.679,00 -3.045,00
'
' P format using en-US culture: 167,900.00% -304,500.00%
' P format using fr-FR culture: 167 900,00 % -304 500,00 %
' P format using es-ES culture: 167.900,00 % -304.500,00 %
'
' X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
' X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
' X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
備註
ToString(String, IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件,以指定格式格式化 Int64 值。 如果您想要使用預設格式或文化特性設定,請使用 ToString 方法的其他多載,如下所示:
使用格式 | 針對文化特性 | 使用多載 |
---|---|---|
預設值 (“G”) 格式 | 預設 (目前) 文化特性 | ToString() |
預設值 (“G”) 格式 | 特定文化特性 | ToString(IFormatProvider) |
特定格式 | 預設 (目前) 文化特性 | ToString(String) |
format
參數可以是標準或自定義數值格式字串。 支援 「R」 以外的所有標準數值格式字串(或 」r“),如同所有自定義數值格式字元一樣。 如果 format
是 null
或空字串 (“),則這個實例的傳回值會以一般數值格式規範 (”G“ 格式化)。
provider
參數是實作 IFormatProvider 介面的物件。 其 GetFormat 方法會傳回 NumberFormatInfo 物件,提供這個方法所傳回之字串格式的文化特性特定資訊。 實作 IFormatProvider 的物件可以是下列任一項:
CultureInfo 物件,表示要使用的格式化規則文化特性。
NumberFormatInfo 物件,其中包含這個值的特定數值格式資訊。
實作 IFormatProvider 的自定義物件,其 GetFormat 方法會傳回提供格式資訊的 NumberFormatInfo 物件。
如果 provider
null
或無法從 provider
取得 NumberFormatInfo 物件,則這個實例的傳回值會以目前文化特性的 NumberFormatInfo 來格式化。
.NET 提供廣泛的格式支援,如下列格式化主題中更詳細地說明:
另請參閱
- Parse(String)
- .NET 中的格式設定類型
- 標準數值格式字串
- 自定義數值格式字串
- 如何:以前置零填補數位,
- 範例:.NET Core WinForms 格式化公用程式 (C#)
- 範例:.NET Core WinForms 格式化公用程式 (Visual Basic)