Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Decimal.ToString-Methode: (String)

 

Veröffentlicht: Oktober 2016

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public string ToString(
	string format
)

Parameter

format
Type: System.String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge (siehe Hinweise).

Rückgabewert

Type: System.String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.

Exception Condition
FormatException

format ist ungültig.

Die ToString(String) -Methode formatiert einen Decimal Wert in einem angegebenen Format mit den Konventionen der aktuellen Kultur. Wenn Sie die Standardeinstellung ("G" oder Allgemeines) verwenden möchten formatieren oder eine andere Kultur angegeben, Verwendung der anderen Überladungen der ToString -Methode wie folgt:

Format verwenden

Für die Kultur

Verwenden Sie die Überladung

Standardformat ("G")

Standardkultur (aktueller)

ToString()

Standardformat ("G")

Eine bestimmte Kultur

ToString(IFormatProvider)

Einem bestimmten format

Eine bestimmte Kultur

ToString(String, IFormatProvider)

Die ToString Methode verwendet die standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge gemäß der format Parameter, um den Wert der aktuellen Instanz in seine Zeichenfolgendarstellung zu konvertieren. Die format Parameter kann eine beliebige gültige numerischer Standardformatbezeichner außer D, R, und X sowie eine beliebige Kombination von benutzerdefinierten Zahlenformatbezeichner. Wenn format ist null oder eine leere Zeichenfolge ist, der Rückgabewert dieser Instanz mit dem allgemeinen numerische Formatbezeichner (G) formatiert ist.

.NET Framework bietet eine umfangreiche formatierungsunterstützung, dies wird in den folgenden Themen zur Formatierung ausführlicher beschrieben:

Der Rückgabewert wird formatiert, mithilfe der NumberFormatInfo Objekt für die aktuelle Kultur. Rufen Sie zum Anwenden der Formatierungskonventionen der einer angegebenen Kultur der ToString(String, IFormatProvider) Methode.

Das folgende Beispiel zeigt eine Decimal -Wert mit den einzelnen unterstützten numerischen Standardformatbezeichnern zusammen mit zwei benutzerdefinierte numerische Formatzeichenfolgen. Konvertieren Sie die numerischen Werte in Zeichenfolgen, wird im Beispiel die Formatierungskonventionen der Kultur En-US verwendet.

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)

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: