Int64.ToString 方法

定義

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

多載

ToString()

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

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。

ToString(String)

使用指定格式,將這個執行個體的數值轉換成它的相等字串表示。

ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。

ToString()

Source:
Int64.cs
Source:
Int64.cs
Source:
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 提供廣泛的格式設定支援,在下列格式設定主題中會更詳細地說明:

另請參閱

適用於

ToString(IFormatProvider)

Source:
Int64.cs
Source:
Int64.cs
Source:
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 的物件可以是下列任一項:

如果 provider 無法 nullprovider 取得 或 NumberFormatInfo 物件,則傳回值會以 NumberFormatInfo 目前文化特性的 物件格式化。

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

另請參閱

適用於

ToString(String)

Source:
Int64.cs
Source:
Int64.cs
Source:
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)Int64 使用 NumberFormatInfo 代表目前文化特性慣例的 物件,格式化指定格式的值。 如果您想要使用預設 (「G」,或一般) 格式或指定不同的文化特性,請使用 方法的其他多載 ToString ,如下所示:

若要使用格式 針對文化特性 使用多載
預設 (「G」) 格式 預設 (目前) 文化特性 ToString()
預設 (「G」) 格式 特定文化特性 ToString(IFormatProvider)
特定格式 特定文化特性 ToString(String, IFormatProvider)

參數 format 可以是任何有效的標準數值格式規範,但 「R」 除外,以及自訂數值格式規範的任何組合。 如果 formatnull 或空字串 (「」「) ,這個實例的傳回值會以一般數值格式標準格式化, (」G「) 。

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

這個實例的傳回值會以 NumberFormatInfo 目前文化特性的 格式化。

另請參閱

適用於

ToString(String, IFormatProvider)

Source:
Int64.cs
Source:
Int64.cs
Source:
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

物件,提供關於這個執行個體的文化特性格式資訊。

傳回

這個執行個體值的字串表示,如同 formatprovider 所指定。

實作

例外狀況

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 ) 」 以外的所有標準數值格式字串,如所有自訂數值格式字元一樣。 如果 formatnull 或空字串 (「」「) ,則這個實例的傳回值會以一般數值格式標準格式化 (」G「) 。

參數 provider 是實作 IFormatProvider 介面的物件。 其 GetFormat 方法會 NumberFormatInfo 傳回 物件,提供這個方法所傳回之字串格式的文化特性特定資訊。 實作 IFormatProvider 的物件可以是下列任一項:

如果 providernullNumberFormatInfo 無法從 provider 取得 物件,這個實例的傳回值會以 NumberFormatInfo 目前文化特性的 格式化。

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

另請參閱

適用於