Decimal.ToString Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Converteert de numerieke waarde van dit exemplaar naar de equivalente String weergave.

Overloads

Name	Description
ToString(IFormatProvider)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.
ToString(String, IFormatProvider)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven indeling en cultuurspecifieke notatiegegevens.
ToString(String)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.
ToString()	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

ToString(IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.

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

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

public string ToString(IFormatProvider provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parameters

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door provider.

Implementeringen

ToString(IFormatProvider)

Voorbeelden

In het volgende voorbeeld wordt de tekenreeksweergave van een Decimal waarde weergegeven met behulp van CultureInfo objecten die verschillende culturen vertegenwoordigen.

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

Opmerkingen

Met ToString(IFormatProvider) de methode wordt een Decimal waarde opgemaakt in de standaardnotatie (G of algemeen) van een opgegeven cultuur. Als u een andere notatie of de huidige cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De provider parameter is een IFormatProvider implementatie waarvan de IFormatProvider.GetFormat methode een NumberFormatInfo object retourneert. provider Dit is meestal een NumberFormatInfo object of een CultureInfo object. De provider parameter levert cultuurspecifieke informatie die wordt gebruikt in opmaak. Als provider dat het is null, wordt de huidige threadcultuur gebruikt.

Als u een Decimal waarde wilt converteren naar de tekenreeksweergave met behulp van een opgegeven cultuur en een specifieke notatietekenreeks, roept u de Decimal.ToString(String, IFormatProvider) methode aan.

Zie ook

Van toepassing op

ToString(String, IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven indeling en cultuurspecifieke notatiegegevens.

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

Parameters

format: String

Een tekenreeks met een numerieke notatie.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format en provider.

Implementeringen

ToString(String, IFormatProvider)

Uitzonderingen

FormatException

format is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een Decimal waarde weergegeven met behulp van elk van de ondersteunde standaardnotatieaanduidingen voor numerieke notaties voor verschillende culturen.

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 %

Opmerkingen

Met ToString(String, IFormatProvider) de methode wordt een Decimal waarde opgemaakt in een opgegeven notatie van een opgegeven cultuur. Als u standaardindeling of cultuurinstellingen wilt gebruiken, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)

De format parameter kan elke geldige standaardnotatieaanduiding voor numerieke notatie zijn, met uitzondering van D, R en X, evenals elke combinatie van aangepaste numerieke notatieaanduidingen. Als format dit een of een lege tekenreeks is null , wordt de retourwaarde voor dit exemplaar opgemaakt met de algemene numerieke notatieaanduiding ('G').

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De provider parameter is een IFormatProvider implementatie waarvan de IFormatProvider.GetFormat methode een NumberFormatInfo object retourneert. provider Dit is meestal een NumberFormatInfo of CultureInfo object. De provider parameter levert cultuurspecifieke informatie die wordt gebruikt in opmaak. Als provider dat het is null, wordt de huidige threadcultuur gebruikt.

Zie ook

Van toepassing op

ToString(String)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.

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

Parameters

format: String

Een standaardtekenreeks of aangepaste numerieke notatie.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format.

Uitzonderingen

FormatException

format is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een Decimal waarde weergegeven met elk van de ondersteunde standaardnotatieaanduidingen voor numerieke notatie, samen met twee aangepaste tekenreeksen voor numerieke notatie. Bij het converteren van de numerieke waarden naar tekenreeksen gebruikt het voorbeeld de opmaakconventies van de en-US cultuur.

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)

Opmerkingen

Met ToString(String) de methode wordt een Decimal waarde in een opgegeven indeling opgemaakt met behulp van de conventies van de huidige cultuur. Als u de standaardindeling ('G', of algemeen) wilt gebruiken of een andere cultuur wilt opgeven, gebruikt u de andere overbelastingen van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

De ToString methode gebruikt de standaard- of aangepaste tekenreeks voor numerieke notatie die is opgegeven door de format parameter om de waarde van het huidige exemplaar te converteren naar de tekenreeksweergave. De format parameter kan elke geldige standaardnotatieaanduiding voor numerieke notatie zijn, met uitzondering van D, R en X, evenals elke combinatie van aangepaste numerieke notatieaanduidingen. Als format dit een of een lege tekenreeks is null , wordt de retourwaarde van dit exemplaar opgemaakt met de algemene numerieke notatieaanduiding (G).

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De retourwaarde wordt opgemaakt met behulp van het NumberFormatInfo object voor de huidige cultuur. Als u de opmaakconventies van een opgegeven cultuur wilt toepassen, roept u de ToString(String, IFormatProvider) methode aan.

Zie ook

Van toepassing op

ToString()

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retouren

String

Een tekenreeks die de waarde van dit exemplaar vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld wordt een Decimal waarde weergegeven met behulp van de standaardmethode ToString() . Ook worden de tekenreeksweergaven weergegeven van de Decimal waarde die het resultaat is van het gebruik van een aantal standaardnotatieaanduidingen.

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

In het volgende voorbeeld wordt het bedrag van het geld in een account weergegeven.

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

Opmerkingen

Met ToString() de methode wordt een Decimal waarde opgemaakt in de standaardnotatie (G of algemeen) van de huidige cultuur. Als u een andere indeling of cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?