Decimal.ToString Metódus

Definíció

Névtér:: System

Szerelvények:: mscorlib.dll, System.Runtime.dll

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: mscorlib.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A példány numerikus értékét a megfelelő String ábrázolásúvá alakítja.

Túlterhelések

Name	Description
ToString()	A példány numerikus értékét a megfelelő sztring-ábrázolásúvá alakítja.
ToString(IFormatProvider)	A példány numerikus értékét a megadott kultúraspecifikus formátumadatok használatával konvertálja a megfelelő sztringre.
ToString(String)	A megadott formátum használatával a példány numerikus értékét a megfelelő sztring-ábrázolásúvá alakítja.
ToString(String, IFormatProvider)	Ennek a példánynak a numerikus értékét a megadott formátum- és kultúraspecifikus formátuminformációk használatával konvertálja a megfelelő sztringre.

ToString()

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

A példány numerikus értékét a megfelelő sztring-ábrázolásúvá alakítja.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Válaszok

String

A példány értékét képviselő sztring.

Példák

Az alábbi példa egy Decimal értéket jelenít meg az alapértelmezett ToString() módszerrel. Emellett megjeleníti annak az értéknek a Decimal sztringábrázolásait is, amelyek több szabványos formátumkijelölő használatával származnak.

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

Az alábbi példa egy fiókban lévő pénzösszeget jeleníti meg.

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

Megjegyzések

A ToString() metódus az Decimal aktuális kultúra alapértelmezett ("G" vagy általános) formátumában formázza az értéket. Ha más formátumot vagy kultúrát szeretne megadni, használja a metódus többi túlterhelését az ToString alábbiak szerint:

Formátum használata	A kultúra	A túlterhelés használata
Alapértelmezett ("G") formátum	Egy adott kultúra	ToString(IFormatProvider)
Egy adott formátum	Alapértelmezett (aktuális) kultúra	ToString(String)
Egy adott formátum	Egy adott kultúra	ToString(String, IFormatProvider)

.NET széles körű formázási támogatást nyújt, amelyet részletesebben a következő formázási témakörökben ismertetünk:

További információ a numerikus formázási sztringekről: Standard numerikus formázási sztringek és egyéni numerikus formázási sztringek.
A formázásról további információt a Formázástípusok című témakörben talál.

Lásd még

A következőre érvényes:

ToString(IFormatProvider)

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

A példány numerikus értékét a megadott kultúraspecifikus formátumadatok használatával konvertálja a megfelelő sztringre.

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

Paraméterek

provider: IFormatProvider

Egy objektum, amely kultúraspecifikus formázási információkat tartalmaz.

Válaszok

String

A példány értékének sztringábrázolása a megadott módon provider.

Megvalósítás

ToString(IFormatProvider)

Példák

Az alábbi példa egy érték sztring-ábrázolását Decimal jeleníti meg különböző kultúrákat képviselő objektumok használatával CultureInfo .

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

Megjegyzések

A ToString(IFormatProvider) metódus egy Decimal adott kultúra alapértelmezett ("G" vagy általános) formátumában formázza az értéket. Ha más formátumot vagy jelenlegi kultúrát szeretne megadni, használja a metódus többi túlterhelését az ToString alábbiak szerint:

Formátum használata	A kultúra	A túlterhelés használata
Alapértelmezett ("G") formátum	Alapértelmezett (aktuális) kultúra	ToString()
Egy adott formátum	Alapértelmezett (aktuális) kultúra	ToString(String)
Egy adott formátum	Egy adott kultúra	ToString(String, IFormatProvider)

.NET széles körű formázási támogatást nyújt, amelyet részletesebben a következő formázási témakörökben ismertetünk:

További információ a numerikus formázási sztringekről: Standard numerikus formázási sztringek és egyéni numerikus formázási sztringek.
A formázásról további információt a Formázástípusok című témakörben talál.

A provider paraméter egy IFormatProvider implementáció, amelynek IFormatProvider.GetFormat metódusa egy objektumot NumberFormatInfo ad vissza. Általában provider egy NumberFormatInfo objektum vagy objektum CultureInfo . A provider paraméter a formázáshoz használt kultúraspecifikus információkat tartalmazza. Ha provider igen null, akkor a szál aktuális kultúrája lesz használva.

Ha egy Decimal értéket egy adott kultúrával és egy adott formátumsztringgel szeretne átalakítani a sztringre, hívja meg a metódust Decimal.ToString(String, IFormatProvider) .

Lásd még

A következőre érvényes:

ToString(String)

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

A megadott formátum használatával a példány numerikus értékét a megfelelő sztring-ábrázolásúvá alakítja.

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

Paraméterek

format: String

Standard vagy egyéni numerikus formátumú sztring.

Válaszok

String

A példány értékének sztringábrázolása a megadott módon format.

Kivételek

FormatException

format érvénytelen.

Példák

Az alábbi példa egy Decimal értéket jelenít meg a támogatott standard numerikus formátumkijelölők és két egyéni numerikus formázási sztring használatával. A numerikus értékek sztringekké alakításakor a példa a en-US kultúra formázási konvencióira hivatkozik.

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)

Megjegyzések

A ToString(String) metódus az aktuális kultúra konvencióit használva formázza Decimal az értékeket egy megadott formátumban. Ha az alapértelmezett ("G" vagy általános) formátumot szeretné használni, vagy másik kultúrát szeretne megadni, használja a metódus többi túlterhelését az ToString alábbiak szerint:

Formátum használata	A kultúra	A túlterhelés használata
Alapértelmezett ("G") formátum	Alapértelmezett (aktuális) kultúra	ToString()
Alapértelmezett ("G") formátum	Egy adott kultúra	ToString(IFormatProvider)
Egy adott formátum	Egy adott kultúra	ToString(String, IFormatProvider)

A ToString metódus a paraméter által megadott standard vagy egyéni numerikus formátumú sztringet használja az format aktuális példány értékének sztringképké alakításához. A format paraméter a D, az R és az X kivételével bármely érvényes standard numerikus formátum-meghatározó lehet, valamint az egyéni numerikus formátumok tetszőleges kombinációja is. Ha format üres null sztring, akkor a példány visszatérési értéke az általános numerikus formátumkijelölővel (G) van formázva.

.NET széles körű formázási támogatást nyújt, amelyet részletesebben a következő formázási témakörökben ismertetünk:

További információ a numerikus formázási sztringekről: Standard numerikus formázási sztringek és egyéni numerikus formázási sztringek.
A formázásról további információt a Formázástípusok című témakörben talál.

A visszatérési érték formátuma az NumberFormatInfo aktuális kultúra objektumának használatával történik. Egy adott kultúra formázási konvencióinak alkalmazásához hívja meg a metódust ToString(String, IFormatProvider) .

Lásd még

A következőre érvényes:

ToString(String, IFormatProvider)

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Forrás:: Decimal.cs

Ennek a példánynak a numerikus értékét a megadott formátum- és kultúraspecifikus formátuminformációk használatával konvertálja a megfelelő sztringre.

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

Paraméterek

format: String

Numerikus formátumú sztring.

provider: IFormatProvider

Egy objektum, amely kultúraspecifikus formázási információkat tartalmaz.

Válaszok

String

A példány format értékének sztringábrázolása az and provider.

Megvalósítás

ToString(String, IFormatProvider)

Kivételek

FormatException

format érvénytelen.

Példák

Az alábbi példa egy Decimal értéket jelenít meg, amely több különböző kultúra támogatott standard numerikus formátum-megjelölőinek mindegyikét használja.

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 %

Megjegyzések

A ToString(String, IFormatProvider) metódus egy Decimal adott kultúra megadott formátumában formázza az értéket. Ha alapértelmezett formátum- vagy kulturális beállításokat szeretne használni, használja a metódus többi túlterhelését az ToString alábbiak szerint:

Formátum használata	A kultúra	A túlterhelés használata
Alapértelmezett ("G") formátum	Alapértelmezett (aktuális) kultúra	ToString()
Alapértelmezett ("G") formátum	Egy adott kultúra	ToString(IFormatProvider)
Egy adott formátum	Alapértelmezett (aktuális) kultúra	ToString(String)

A format paraméter a D, az R és az X kivételével bármely érvényes standard numerikus formátum-meghatározó lehet, valamint az egyéni numerikus formátumok tetszőleges kombinációja is. Ha format üres null sztring, akkor a példány visszatérési értéke az általános numerikus formátumjelölővel ("G") van formázva.

.NET széles körű formázási támogatást nyújt, amelyet részletesebben a következő formázási témakörökben ismertetünk:

További információ a numerikus formázási sztringekről: Standard numerikus formázási sztringek és egyéni numerikus formázási sztringek.
A formázásról további információt a Formázástípusok című témakörben talál.

A provider paraméter egy IFormatProvider implementáció, amelynek IFormatProvider.GetFormat metódusa egy objektumot NumberFormatInfo ad vissza. Általában provider egy vagy NumberFormatInfo több CultureInfo objektum. A provider paraméter a formázáshoz használt kultúraspecifikus információkat tartalmazza. Ha provider igen null, akkor a szál aktuális kultúrája lesz használva.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?