Decimal.ToString 方法

定義

命名空間:

System

組件:

System.Runtime.dll

將這個執行個體的數值轉換成其對等的 String 表示。

多載

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

ToString()

Source:

Decimal.cs

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

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

傳回

String

字串，表示這個執行個體的值。

範例

下列範例會使用預設 ToString() 方法顯示 Decimal 值。 它也會顯示使用一些標準格式規範所產生的值字串表示 Decimal 。

decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62

let value = -16325.62m
// Display value using default ToString method.
printfn $"{value.ToString()}"            // Displays -16325.62
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""      // Displays -16325.62
printfn $"""{value.ToString "C"}"""      // Displays ($16,325.62)
printfn $"""{value.ToString "F"}"""      // Displays -16325.62

Dim value As Decimal = -16325.62d
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325.62
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325.62
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.62)
Console.WriteLine(value.ToString("F"))         ' Displays -16325.62

下列範例會顯示帳戶中的金額。

   public ref class PiggyBank
   {
   public:
      void AddPenny()
      {
         MyFortune = Decimal::Add( MyFortune, (Decimal).01 );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }

   protected:
      Decimal MyFortune;
   };
}

class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}

type PiggyBank() =
    let mutable myFortune = 0m

    member _.AddPenny() =
        myFortune <- Decimal.Add(myFortune, 0.01m)

    override _.ToString() =
        $"{myFortune:C} in piggy bank"

Class PiggyBank

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function

    Protected MyFortune As Decimal
End Class

備註

方法會將 ToString() 值格式化 Decimal 為預設 (「G」，或目前文化特性的一般) 格式。 如果您想要指定不同的格式或文化特性，請使用 方法的其他多載 ToString ，如下所示：

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

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

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自訂數值格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

另請參閱

• Parse(String)
• 在 .NET 中將類型格式化
• 標準數值格式字串

ToString(IFormatProvider)

Source:

Decimal.cs

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

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

參數

provider

IFormatProvider

物件，提供特定文化特性格式資訊。

傳回

String

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

實作

ToString(IFormatProvider)

範例

下列範例會使用 CultureInfo 代表數個 Decimal 不同文化特性的物件，顯示值的字串表示。

decimal value = -16325.62m;
// 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:
//       -16325.62
//       -16325.62
//       -16325,62

let value = -16325.62m
// 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:
//       -16325.62
//       -16325.62
//       -16325,62

Dim value As Decimal = -16325.62d
' 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:
'       -16325.62
'       -16325.62
'       -16325,62

備註

方法會將 ToString(IFormatProvider) 值格式化 Decimal 為預設 (「G」，或指定文化特性的一般) 格式。 如果您想要指定不同的格式或目前的文化特性，請使用 方法的其他多載 ToString ，如下所示：

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

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

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自訂數值格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

參數 provider 是實 IFormatProvider 作，其方法會 NumberFormatInfo 傳 IFormatProvider.GetFormat 回 物件。 一般而言， provider 是 NumberFormatInfo 物件或 CultureInfo 物件。 參數 provider 會提供用於格式設定的文化特性特定資訊。 如果 provider 是 null，則會使用執行緒目前的文化特性。

若要使用指定的文化特性和特定的格式字串，將值轉換為 Decimal 其字串標記法，請呼叫 Decimal.ToString(String, IFormatProvider) 方法。

另請參閱

• Parse(String)
• 在 .NET 中將類型格式化
• 標準數值格式字串

ToString(String)

Source:

Decimal.cs

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

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

參數

format

String

標準或自訂數值格式字串。

傳回

String

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

例外狀況

FormatException

format 無效。

範例

下列範例會使用每個支援的標準數值格式規範，以及兩個 Decimal 自訂數值格式字串來顯示值。 在將數值轉換成字串時，此範例會使用 en-US 文化特性的格式設定慣例。

decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): (16,325.62)

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: 16325.62
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: $16,325.62
let specifier = "E04"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E04: 1.6326E+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: 16325.62
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    N: 16,325.62
let specifier = "P"
printfn $"{specifier}: {(value / 10000m).ToString specifier}"
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    0,0.000: 16,325.620
let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1m).ToString specifier}"
// Displays:    #,#.00#(#,#.00#): (16,325.62)

Dim value As Decimal = 16325.62d
Dim specifier As String

' Use standard numeric format specifiers.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: 16325.62
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: $16,325.62
specifier = "E04"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E04: 1.6326E+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: 16325.62
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: 16,325.62
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier))
' Displays:    P: 163.26 %

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): (16,325.62)

備註

方法 ToString(String) 會使用目前文化特性的慣例，以指定格式格式化 Decimal 值。 如果您想要使用預設 (「G」，或一般) 格式或指定不同的文化特性，請使用 方法的其他多載 ToString ，如下所示：

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

方法 ToString 會使用 參數所 format 指定的標準或自訂數值格式字串，將目前實例的值轉換成其字串表示。 參數 format 可以是 D、R 和 X 以外的任何有效 標準數值格式規範 ，以及 自訂數值格式規範的任何組合。 如果 是 formatnull 或空字串，這個實例的傳回值會以一般數值格式標準格式化， (G) 。

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

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自訂數值格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

傳回值是使用目前 NumberFormatInfo 文化特性的 物件來格式化。 若要套用指定文化特性的格式設定慣例，請呼叫 ToString(String, IFormatProvider) 方法。

另請參閱

• Parse(String)
• 在 .NET 中將類型格式化
• 標準數值格式字串
• Custom Numeric Format Strings
• 作法：以前置字元零來填補數字

ToString(String, IFormatProvider)

Source:

Decimal.cs

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

public:
 virtual System::String ^ ToString(System::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)

例外狀況

FormatException

format 無效。

範例

下列範例會針對數個不同的 Decimal 文化特性，使用每個支援的標準數值格式規範來顯示值。

decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
// Displays:    16325.62

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    $16,325.62
let culture = CultureInfo.CreateSpecificCulture "en-GB"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    £16,325.62

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
Console.WriteLine(value.ToString(specifier, culture))
// Displays: 1,6326E+004
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    1.6326E+004

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
let culture = CultureInfo.CreateSpecificCulture "en-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325.62

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16.325,62
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16 325,62

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.256 %

Dim value As Decimal = 16325.62d
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.62

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.62

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,62

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

備註

方法會 ToString(String, IFormatProvider) 以指定文化特性的指定格式格式化 Decimal 值。 如果您想要使用預設格式或文化特性設定，請使用 方法的其他多載 ToString ，如下所示：

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

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

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

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自訂數值格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

參數 provider 是 IFormatProvider 實作，其方法會 NumberFormatInfo 傳 IFormatProvider.GetFormat 回 物件。 一般而言， provider 是 NumberFormatInfo 或 CultureInfo 物件。 參數 provider 提供格式化中使用的文化特性特定資訊。 如果 provider 是 null，則會使用執行緒目前的文化特性。

另請參閱

• Parse(String)
• 在 .NET 中將類型格式化
• 標準數值格式字串
• Custom Numeric Format Strings
• 作法：以前置字元零來填補數字