Decimal.ToString Decimal.ToString Decimal.ToString Decimal.ToString Method

Definition

Konvertiert den numerischen Wert dieser Instanz in die entsprechende String-Darstellung.Converts the numeric value of this instance to its equivalent String representation.

Überlädt

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

Parameter

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider.The string representation of the value of this instance as specified by provider.

Implementiert

Beispiele

Das folgende Beispiel zeigt die angegebene Zeichenfolgendarstellung einer Decimal -Wert mithilfe CultureInfo Objekte, die verschiedene Kulturen darstellen.The following example displays the string representation of a Decimal value using CultureInfo objects that represent several different cultures.

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
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

Hinweise

Die ToString(IFormatProvider) -Methode formatiert einen Decimal Wert in der Standardeinstellung ("G" oder Allgemein) Format einer angegebenen Kultur.The ToString(IFormatProvider) method formats a Decimal value in the default ("G", or general) format of a specified culture. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie alle anderen Überladungen der der ToString -Methode wie folgt:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Die provider -Parameter ist ein IFormatProvider Implementierung, deren IFormatProvider.GetFormat Methode gibt eine NumberFormatInfo Objekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. In der Regel provider ist eine NumberFormatInfo Objekt oder ein CultureInfo Objekt.Typically, provider is a NumberFormatInfo object or a CultureInfo object. Die provider Parameter liefert kulturspezifische Informationen, die bei der Formatierung verwendete.The provider parameter supplies culture-specific information used in formatting. Wenn provider gleich null ist, wird die aktuelle Threadkultur verwendet.If provider is null, the thread current culture is used.

Konvertiert eine Decimal Wert in seine Zeichenfolgendarstellung, die mit einer angegebenen Kultur und einem bestimmten Format String Aufruf der Decimal.ToString(String, IFormatProvider) Methode.To convert a Decimal value to its string representation using a specified culture and a specific format string, call the Decimal.ToString(String, IFormatProvider) method.

Siehe auch

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

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

Parameter

format
String String String String

Eine numerische Formatierungszeichenfolge.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format und provider.The string representation of the value of this instance as specified by format and provider.

Implementiert

Ausnahmen

format ist ungültig.format is invalid.

Beispiele

Das folgende Beispiel zeigt eine Decimal Wert mit einer der unterstützten standardzahlen-Formatbezeichnern für verschiedene Kulturen.The following example displays a Decimal value using each of the supported standard numeric format specifiers for several different cultures.

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 %
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 %

Hinweise

Die ToString(String, IFormatProvider) -Methode formatiert einen Double Wert in einem angegebenen Format einer angegebenen Kultur.The ToString(String, IFormatProvider) method formats a Double value in a specified format of a specified culture. Wenn Sie die Standardeinstellungen Format oder die Kultur verwenden möchten, verwenden Sie alle anderen Überladungen der der ToString -Methode wie folgt:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)

Die format Parameter kann eine beliebige gültige numerischer Standardformatbezeichner außer D "," R "und" X sowie eine beliebige Kombination aus benutzerdefinierten Zahlenformatbezeichner sein.The format parameter can be any valid standard numeric format specifier except for D, R, and X, as well as any combination of custom numeric format specifiers. Wenn format ist null oder eine leere Zeichenfolge und der Rückgabewert für diese Instanz mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist.If format is null or an empty string, the return value for this instance is formatted with the general numeric format specifier ("G").

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Die provider -Parameter ist ein IFormatProvider Implementierung, deren IFormatProvider.GetFormat Methode gibt eine NumberFormatInfo Objekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. In der Regel provider ist eine NumberFormatInfo oder CultureInfo Objekt.Typically, provider is a NumberFormatInfo or CultureInfo object. Die provider Parameter liefert kulturspezifische Informationen, die bei der Formatierung verwendete.The provider parameter supplies culture-specific information used in formatting. Wenn provider gleich null ist, wird die aktuelle Threadkultur verwendet.If provider is null, the thread current culture is used.

Siehe auch

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

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

Parameter

format
String String String String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.A standard or custom numeric format string.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.The string representation of the value of this instance as specified by format.

Ausnahmen

format ist ungültig.format is invalid.

Beispiele

Das folgende Beispiel zeigt eine Decimal Wert mit einer der unterstützten standardmäßigen Zahlenformatbezeichner, zusammen mit zwei benutzerdefinierte numerische Formatzeichenfolgen.The following example displays a Decimal value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. Bei der Konvertierung die numerischen Werte in Zeichenfolgen, verwendet das Beispiel die Formatierungskonventionen der Kultur En-US.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

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)
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)

Hinweise

Die ToString(String) -Methode formatiert einen Decimal Wert in einem angegebenen Format mithilfe der Konventionen der aktuellen Kultur.The ToString(String) method formats a Decimal value in a specified format by using the conventions of the current culture. Wenn Sie die Standardeinstellung ("G" oder allgemeine) verwenden möchten formatieren oder eine andere Kultur angeben, verwenden Sie die anderen Überladungen von der ToString -Methode wie folgt:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Die ToString Methode verwendet die standardmäßige oder benutzerdefinierte numerische Formatzeichenfolge gemäß den format Parameter, um den Wert der aktuellen Instanz in seine Zeichenfolgendarstellung zu konvertieren.The ToString method uses the standard or custom numeric format string specified by the format parameter to convert the value of the current instance into its string representation. Die format Parameter kann eine beliebige gültige sein numerischer Standardformatbezeichner mit Ausnahme von D, R, X, sowie eine beliebige Kombination von benutzerdefinierten Zahlenformatbezeichner.The format parameter can be any valid standard numeric format specifier except for D, R, and X, as well as any combination of custom numeric format specifiers. Wenn format ist null oder eine leere Zeichenfolge ist, der Rückgabewert von dieser Instanz mit dem allgemeinen numerische Formatbezeichner (G) formatiert ist.If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier (G).

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der Rückgabewert formatiert wird, mithilfe der NumberFormatInfo Objekt für die aktuelle Kultur.The return value is formatted by using the NumberFormatInfo object for the current culture. Rufen Sie zum Anwenden der Formatierungskonventionen der angegebenen Kultur der ToString(String, IFormatProvider) Methode.To apply the formatting conventions of a specified culture, call the ToString(String, IFormatProvider) method.

Siehe auch

ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

Eine Zeichenfolge, die den Wert dieser Instanz darstellt.A string that represents the value of this instance.

Beispiele

Das folgende Beispiel zeigt eine Decimal -Wert mithilfe der standardmäßigen ToString() Methode.The following example displays a Decimal value using the default ToString() method. Es zeigt auch die zeichenfolgendarstellungen der Decimal -Wert, der über eine Reihe von den Standardformatbezeichnern entstehen.It also displays the string representations of the Decimal value that result from using a number of standard format specifiers.

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      
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      

Das folgende Beispiel zeigt die Menge an Geld in einem Konto an.The following example displays the amount of money in an account.

   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;
}
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

Hinweise

Die ToString() -Methode formatiert einen Decimal Wert in der Standardeinstellung ("G" oder Allgemein) Format der aktuellen Kultur.The ToString() method formats a Decimal value in the default ("G", or general) format of the current culture. Wenn Sie ein anderes Format oder die Kultur angeben möchten, verwenden Sie alle anderen Überladungen der der ToString -Methode wie folgt:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Siehe auch

Gilt für: