Convert.ToDecimal Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Konvertiert einen angegebenen Wert in eine Dezimalzahl.

Überlädt

ToDecimal(Single)	Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in die entsprechende Dezimalzahl.
ToDecimal(String)	Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl in eine entsprechende Dezimalzahl.
ToDecimal(UInt16)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(String, IFormatProvider)	Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in eine entsprechende Dezimalzahl.
ToDecimal(UInt64)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(Object, IFormatProvider)	Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in eine entsprechende Dezimalzahl.
ToDecimal(SByte)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in die entsprechende Dezimalzahl.
ToDecimal(UInt32)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(Object)	Konvertiert den Wert des angegebenen Objekts in eine entsprechende Dezimalzahl.
ToDecimal(Int64)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(Int32)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(Int16)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.
ToDecimal(Double)	Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in eine entsprechende Dezimalzahl.
ToDecimal(Decimal)	Gibt die angegebene Dezimalzahl zurück. Es wird keine wirkliche Konvertierung durchgeführt.
ToDecimal(DateTime)	Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.
ToDecimal(Char)	Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.
ToDecimal(Byte)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Dezimalzahl.
ToDecimal(Boolean)	Konvertiert den angegebenen booleschen Wert in die entsprechende Dezimalzahl.

ToDecimal(Single)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in die entsprechende Dezimalzahl.

public static decimal ToDecimal (float value);

Parameter

value

Single

Die zu konvertierende Gleitkommazahl mit einfacher Genauigkeit.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Ausnahmen

OverflowException

value ist größer als Decimal.MaxValue oder kleiner als Decimal.MinValue.

Beispiele

Im folgenden Beispiel wird versucht, jedes Element in einem Array von Single Werten in einen Decimal Wert zu konvertieren.

float[] numbers = { Single.MinValue, -3e10f, -1093.54f, 0f, 1e-03f,
                    1034.23f, Single.MaxValue };
decimal result;

foreach (float number in numbers)
{
   try {
      result = Convert.ToDecimal(number);
      Console.WriteLine("Converted the Single value {0} to {1}.", number, result);
   }
   catch (OverflowException) {
      Console.WriteLine("{0} is out of range of the Decimal type.", number);
   }
}
// The example displays the following output:
//       -3.402823E+38 is out of range of the Decimal type.
//       Converted the Single value -3E+10 to -30000000000.
//       Converted the Single value -1093.54 to -1093.54.
//       Converted the Single value 0 to 0.
//       Converted the Single value 0.001 to 0.001.
//       Converted the Single value 1034.23 to 1034.23.
//       3.402823E+38 is out of range of the Decimal type.

Hinweise

Der Decimal von dieser Methode zurückgegebene Wert enthält maximal sieben signifikante Ziffern. Wenn der value Parameter mehr als sieben signifikante Ziffern enthält, wird er durch Rundung auf die nächste gerundet. Im folgenden Beispiel wird veranschaulicht, wie die ToDecimal(Single) Methode eine Rundung auf die nächste verwendet, um einen Decimal Wert mit sieben signifikanten Ziffern zurückzugeben.

Console.WriteLine(Convert.ToDecimal(1234567500.12F));  // Displays 1234568000
Console.WriteLine(Convert.ToDecimal(1234568500.12F));  // Displays 1234568000

Console.WriteLine(Convert.ToDecimal(10.980365F));      // Displays 10.98036
Console.WriteLine(Convert.ToDecimal(10.980355F));      // Displays 10.98036

Weitere Informationen

• Single

ToDecimal(String)

Quelle:

Convert.cs

Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (string? value);

Parameter

value

String

Eine Zeichenfolge, die eine zu konvertierende Zahl enthält.

Gibt zurück

Decimal

Eine Dezimalzahl, die der Zahl in value entspricht, oder 0 (null), wenn value gleich null ist.

Ausnahmen

FormatException

value stellt keine Zahl in einem gültigen Format dar.

OverflowException

value stellt eine Zahl dar, die kleiner als Decimal.MinValue oder größer als Decimal.MaxValue ist.

Beispiele

Im folgenden Beispiel wird die Verwendung von ToDecimal veranschaulicht. Es versucht, ein String in einen Decimalzu konvertieren, und löst die möglichen Ausnahmen aus, die während der Konvertierung auftreten können.

public void ConvertStringDecimal(string stringVal) {
    decimal decimalVal = 0;
    
    try {
        decimalVal = System.Convert.ToDecimal(stringVal);
        System.Console.WriteLine(
            "The string as a decimal is {0}.", decimalVal);
    }
    catch (System.OverflowException){
        System.Console.WriteLine(
            "The conversion from string to decimal overflowed.");
    }
    catch (System.FormatException) {
        System.Console.WriteLine(
            "The string is not formatted as a decimal.");
    }
    catch (System.ArgumentNullException) {
        System.Console.WriteLine(
            "The string is null.");
    }

    // Decimal to string conversion will not overflow.
    stringVal = System.Convert.ToString(decimalVal);
    System.Console.WriteLine(
        "The decimal as a string is {0}.", stringVal);
}

Hinweise

Die Verwendung der ToDecimal(String) -Methode entspricht der Übergabe value an die Decimal.Parse(String) -Methode. value wird mithilfe der Formatierungskonventionen der aktuellen Kultur interpretiert.

Wenn Sie es vorziehen, keine Ausnahme zu behandeln, wenn die Konvertierung fehlschlägt, können Sie stattdessen die Decimal.TryParse -Methode aufrufen. Es gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

ToDecimal(UInt16)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.

[System.CLSCompliant(false)]
public static decimal ToDecimal (ushort value);

Parameter

value

UInt16

Die zu konvertierende 16-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

Decimal

Die Dezimalzahl, die value entspricht.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird ein Array von 16-Bit-Ganzzahlen ohne Vorzeichen in Decimal Werte konvertiert.

ushort[] numbers = { UInt16.MinValue, 121, 12345, UInt16.MaxValue };
decimal result;

foreach (ushort number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the UInt16 value {0} to {1}.",
                     number, result);
}
// The example displays the following output:
//       Converted the UInt16 value 0 to 0.
//       Converted the UInt16 value 121 to 121.
//       Converted the UInt16 value 12345 to 12345.
//       Converted the UInt16 value 65535 to 65535.

Weitere Informationen

• Decimal

ToDecimal(String, IFormatProvider)

Quelle:

Convert.cs

Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (string? value, IFormatProvider? provider);

Parameter

value

String

Eine Zeichenfolge, die eine zu konvertierende Zahl enthält.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

Decimal

Eine Dezimalzahl, die der Zahl in value entspricht, oder 0 (null), wenn value gleich null ist.

Ausnahmen

FormatException

value stellt keine Zahl in einem gültigen Format dar.

OverflowException

value stellt eine Zahl dar, die kleiner als Decimal.MinValue oder größer als Decimal.MaxValue ist.

Beispiele

Im folgenden Beispiel wird versucht, ein Array von Zeichenfolgen mithilfe NumberFormatInfo von Objekten, die zwei verschiedene Kulturen darstellen, in Werte zu Decimal konvertieren.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { "123456789", "12345.6789", "12 345,6789",
                          "123,456.789", "123 456,789", "123,456,789.0123",
                          "123 456 789,0123" };
      CultureInfo[] cultures = { new CultureInfo("en-US"),
                                 new CultureInfo("fr-FR") };

      foreach (CultureInfo culture in cultures)
      {
         Console.WriteLine("String -> Decimal Conversion Using the {0} Culture",
                           culture.Name);
         foreach (string value in values)
         {
            Console.Write("{0,20}  ->  ", value);
            try {
               Console.WriteLine(Convert.ToDecimal(value, culture));
            }
            catch (FormatException) {
               Console.WriteLine("FormatException");
            }
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       String -> Decimal Conversion Using the en-US Culture
//                  123456789  ->  123456789
//                 12345.6789  ->  12345.6789
//                12 345,6789  ->  FormatException
//                123,456.789  ->  123456.789
//                123 456,789  ->  FormatException
//           123,456,789.0123  ->  123456789.0123
//           123 456 789,0123  ->  FormatException
//
//       String -> Decimal Conversion Using the fr-FR Culture
//                  123456789  ->  123456789
//                 12345.6789  ->  FormatException
//                12 345,6789  ->  12345.6789
//                123,456.789  ->  FormatException
//                123 456,789  ->  123456.789
//           123,456,789.0123  ->  FormatException
//           123 456 789,0123  ->  123456789.0123

Hinweise

Der Rückgabewert ist das Ergebnis des Aufrufs der Decimal.Parse -Methode für value.

providerist eine IFormatProvider instance, die ein NumberFormatInfo -Objekt abruft. Das NumberFormatInfo -Objekt stellt kulturspezifische Informationen zum Format von bereit value. Wenn provider ist null, wird der NumberFormatInfo für die aktuelle Kultur verwendet.

Wenn Sie es vorziehen, keine Ausnahme zu behandeln, wenn die Konvertierung fehlschlägt, können Sie stattdessen die Decimal.TryParse -Methode aufrufen. Es gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

ToDecimal(UInt64)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.

[System.CLSCompliant(false)]
public static decimal ToDecimal (ulong value);

Parameter

value

UInt64

Die zu konvertierende 64-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird ein Array von ganzzahligen Zahlen ohne Vorzeichen in Decimal Werte konvertiert.

ulong[] numbers = { UInt64.MinValue, 121, 12345, UInt64.MaxValue };
decimal result;

foreach (ulong number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the UInt64 value {0} to {1}.",
                     number, result);
}
// The example displays the following output:
//    Converted the UInt64 value 0 to 0.
//    Converted the UInt64 value 121 to 121.
//    Converted the UInt64 value 12345 to 12345.
//    Converted the UInt64 value 18446744073709551615 to 18446744073709551615.

Weitere Informationen

• Decimal

ToDecimal(Object, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (object? value, IFormatProvider? provider);

Parameter

value

Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht, oder 0 (null), wenn value gleich null ist.

Ausnahmen

FormatException

value weist kein geeignetes Format für einen Decimal-Typ auf.

InvalidCastException

Die IConvertible-Schnittstelle wird von value nicht implementiert.

- oder -

Die Konvertierung wird nicht unterstützt.

OverflowException

value stellt eine Zahl dar, die kleiner als Decimal.MinValue oder größer als Decimal.MaxValue ist.

Beispiele

Im folgenden Beispiel wird eine Temperature -Klasse definiert, die die IConvertible -Schnittstelle implementiert.

using System;
using System.Globalization;

public class Temperature : IConvertible
{
   private decimal m_Temp;

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   }

   public decimal Celsius
   {
      get { return this.m_Temp; }
   }

   public decimal Kelvin
   {
      get { return this.m_Temp + 273.15m; }
   }

   public decimal Fahrenheit
   {
      get { return Math.Round((decimal) (this.m_Temp * 9 / 5 + 32), 2); }
   }

   public override string ToString()
   {
      return m_Temp.ToString("N2") + " °C";
   }

   // IConvertible implementations.
   public TypeCode GetTypeCode()
   {
      return TypeCode.Object;
   }

   public bool ToBoolean(IFormatProvider provider)
   {
      if (m_Temp == 0)
         return false;
      else
         return true;
   }

   public byte ToByte(IFormatProvider provider)
   {
      if (m_Temp < Byte.MinValue || m_Temp > Byte.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the Byte type.",
                                                   this.m_Temp));
      else
         return Decimal.ToByte(this.m_Temp);
   }

   public char ToChar(IFormatProvider provider)
   {
      throw new InvalidCastException("Temperature to Char conversion is not supported.");
   }

   public DateTime ToDateTime(IFormatProvider provider)
   {
      throw new InvalidCastException("Temperature to DateTime conversion is not supported.");
   }

   public decimal ToDecimal(IFormatProvider provider)
   {
      return this.m_Temp;
   }

   public double ToDouble(IFormatProvider provider)
   {
      return Decimal.ToDouble(this.m_Temp);
   }

   public short ToInt16(IFormatProvider provider)
   {
      if (this.m_Temp < Int16.MinValue || this.m_Temp > Int16.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the Int16 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToInt16(this.m_Temp);
   }

   public int ToInt32(IFormatProvider provider)
      {
      if (this.m_Temp < Int32.MinValue || this.m_Temp > Int32.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the Int32 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToInt32(this.m_Temp);
   }

   public long ToInt64(IFormatProvider provider)
   {
      if (this.m_Temp < Int64.MinValue || this.m_Temp > Int64.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the Int64 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToInt64(this.m_Temp);
   }

   public sbyte ToSByte(IFormatProvider provider)
   {
      if (this.m_Temp < SByte.MinValue || this.m_Temp > SByte.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the SByte type.",
                                                   this.m_Temp));
      else
         return Decimal.ToSByte(this.m_Temp);
   }

   public float ToSingle(IFormatProvider provider)
   {
      return Decimal.ToSingle(this.m_Temp);
   }

   public string ToString(IFormatProvider provider)
   {
      return m_Temp.ToString("N2", provider) + " °C";
   }

   public object ToType(Type conversionType, IFormatProvider provider)
   {
      switch (Type.GetTypeCode(conversionType))
      {
         case TypeCode.Boolean:
            return this.ToBoolean(null);
         case TypeCode.Byte:
            return this.ToByte(null);
         case TypeCode.Char:
            return this.ToChar(null);
         case TypeCode.DateTime:
            return this.ToDateTime(null);
         case TypeCode.Decimal:
            return this.ToDecimal(null);
         case TypeCode.Double:
            return this.ToDouble(null);
         case TypeCode.Int16:
            return this.ToInt16(null);
         case TypeCode.Int32:
            return this.ToInt32(null);
         case TypeCode.Int64:
            return this.ToInt64(null);
         case TypeCode.Object:
            if (typeof(Temperature).Equals(conversionType))
               return this;
            else
               throw new InvalidCastException(String.Format("Conversion to a {0} is not supported.",
                                                            conversionType.Name));
         case TypeCode.SByte:
            return this.ToSByte(null);
         case TypeCode.Single:
            return this.ToSingle(null);
         case TypeCode.String:
            return this.ToString(provider);
         case TypeCode.UInt16:
            return this.ToUInt16(null);
         case TypeCode.UInt32:
            return this.ToUInt32(null);
         case TypeCode.UInt64:
            return this.ToUInt64(null);
         default:
            throw new InvalidCastException(String.Format("Conversion to {0} is not supported.", conversionType.Name));
      }
   }

   public ushort ToUInt16(IFormatProvider provider)
   {
      if (this.m_Temp < UInt16.MinValue || this.m_Temp > UInt16.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the UInt16 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToUInt16(this.m_Temp);
   }

   public uint ToUInt32(IFormatProvider provider)
   {
      if (this.m_Temp < UInt32.MinValue || this.m_Temp > UInt32.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the UInt32 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToUInt32(this.m_Temp);
   }

   public ulong ToUInt64(IFormatProvider provider)
   {
      if (this.m_Temp < UInt64.MinValue || this.m_Temp > UInt64.MaxValue)
         throw new OverflowException(String.Format("{0} is out of range of the UInt64 type.",
                                                   this.m_Temp));
      else
         return Decimal.ToUInt64(this.m_Temp);
   }
}

Das folgende Beispiel zeigt, dass, wenn ein Temperature Objekt als Parameter an die ToDecimal(Object, IFormatProvider) -Methode übergeben wird, die IConvertible.ToDecimal Implementierung der Temperature -Klasse aufgerufen wird, um die Konvertierung durchzuführen.

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature(-40);
      Temperature freezing = new Temperature(0);
      Temperature boiling = new Temperature(100);

      Console.WriteLine(Convert.ToDecimal(cold, null));
      Console.WriteLine(Convert.ToDecimal(freezing, null));
      Console.WriteLine(Convert.ToDecimal(boiling, null));
   }
}
// The example dosplays the following output:
//       -40
//       0
//       100

Hinweise

Der Rückgabewert ist das Ergebnis des Aufrufs der IConvertible.ToDecimal -Methode des zugrunde liegenden Typs von value.

provider ermöglicht es dem Benutzer, kulturspezifische Konvertierungsinformationen zum Inhalt von valueanzugeben. Die Basistypen ignorieren provider. Der Parameter kann jedoch verwendet werden, wenn es sich um value einen benutzerdefinierten Typ handelt, der die IConvertible Schnittstelle implementiert.

Weitere Informationen

• Decimal

ToDecimal(SByte)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in die entsprechende Dezimalzahl.

[System.CLSCompliant(false)]
public static decimal ToDecimal (sbyte value);

Parameter

value

SByte

Die zu konvertierende 8-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von signierten Bytes in einen Decimal Wert konvertiert.

sbyte[] numbers = { SByte.MinValue, -23, 0, 17, SByte.MaxValue };
decimal result;

foreach (sbyte number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the SByte value {0} to {1}.", number, result);
}
//       Converted the SByte value -128 to -128.
//       Converted the SByte value -23 to -23.
//       Converted the SByte value 0 to 0.
//       Converted the SByte value 17 to 17.
//       Converted the SByte value 127 to 127.

Weitere Informationen

• Decimal

ToDecimal(UInt32)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in eine entsprechende Dezimalzahl.

[System.CLSCompliant(false)]
public static decimal ToDecimal (uint value);

Parameter

value

UInt32

Die zu konvertierende 32-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird ein Array von ganzen Zahlen ohne Vorzeichen in Decimal Werte konvertiert.

uint[] numbers = { UInt32.MinValue, 121, 12345, UInt32.MaxValue };
decimal result;

foreach (uint number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the UInt32 value {0} to {1}.",
                     number, result);
}
// The example displays the following output:
//       Converted the UInt32 value 0 to 0.
//       Converted the UInt32 value 121 to 121.
//       Converted the UInt32 value 12345 to 12345.
//       Converted the UInt32 value 4294967295 to 4294967295.

Weitere Informationen

• Decimal

ToDecimal(Object)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Objekts in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (object? value);

Parameter

value

Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert, oder null.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht, oder 0 (null), wenn value gleich null ist.

Ausnahmen

FormatException

value weist kein geeignetes Format für einen Decimal-Typ auf.

InvalidCastException

Die IConvertible-Schnittstelle wird von value nicht implementiert.

- oder -

Die Konvertierung wird nicht unterstützt.

OverflowException

value stellt eine Zahl dar, die kleiner als Decimal.MinValue oder größer als Decimal.MaxValue ist.

Beispiele

Im folgenden Beispiel wird versucht, jedes Element in einem Objektarray in einen Decimal Wert zu konvertieren.

object[] values = { true, 'a', 123, 1.764e32, "9.78", "1e-02",
                    1.67e03, "A100", "1,033.67", DateTime.Now,
                    Double.MaxValue };
decimal result;

foreach (object value in values)
{
   try {
      result = Convert.ToDecimal(value);
      Console.WriteLine("Converted the {0} value {1} to {2}.",
                        value.GetType().Name, value, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is out of range of the Decimal type.",
                        value.GetType().Name, value);
   }
   catch (FormatException) {
      Console.WriteLine("The {0} value {1} is not recognized as a valid Decimal value.",
                        value.GetType().Name, value);
   }
   catch (InvalidCastException) {
      Console.WriteLine("Conversion of the {0} value {1} to a Decimal is not supported.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Converted the Boolean value True to 1.
//    Conversion of the Char value a to a Decimal is not supported.
//    Converted the Int32 value 123 to 123.
//    The Double value 1.764E+32 is out of range of the Decimal type.
//    Converted the String value 9.78 to 9.78.
//    The String value 1e-02 is not recognized as a valid Decimal value.
//    Converted the Double value 1670 to 1670.
//    The String value A100 is not recognized as a valid Decimal value.
//    Converted the String value 1,033.67 to 1033.67.
//    Conversion of the DateTime value 10/15/2008 05:40:42 PM to a Decimal is not supported.
//    The Double value 1.79769313486232E+308 is out of range of the Decimal type.

Hinweise

Der Rückgabewert ist das Ergebnis des Aufrufs der IConvertible.ToDecimal -Methode des zugrunde liegenden Typs von value.

Weitere Informationen

• Decimal

ToDecimal(Int64)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (long value);

Parameter

value

Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Beispiele

Im folgenden Beispiel wird ein Int64 Wert in einen Decimal Wert konvertiert.

public void ConvertLongDecimal(long longVal) {

    decimal	decimalVal;
    
    // Long to decimal conversion cannot overflow.
    decimalVal = System.Convert.ToDecimal(longVal);
    System.Console.WriteLine("{0} as a decimal is {1}",
            longVal, decimalVal);

    // Decimal to long conversion can overflow.
    try {
        longVal = System.Convert.ToInt64(decimalVal);
        System.Console.WriteLine("{0} as a long is {1}",
            decimalVal, longVal);
    }
    catch (System.OverflowException) {
        System.Console.WriteLine(
            "Overflow in decimal-to-long conversion.");
    }
}

Weitere Informationen

• Decimal

ToDecimal(Int32)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (int value);

Parameter

value

Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Beispiele

Im folgenden Beispiel wird ein Array von ganzen Zahlen mit Vorzeichen in Decimal Werte konvertiert.

int[] numbers = { Int32.MinValue, -1000, 0, 1000, Int32.MaxValue };
decimal result;

foreach (int number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the Int32 value {0} to the Decimal value {1}.",
                     number, result);
}
// The example displays the following output:
//    Converted the Int32 value -2147483648 to the Decimal value -2147483648.
//    Converted the Int32 value -1000 to the Decimal value -1000.
//    Converted the Int32 value 0 to the Decimal value 0.
//    Converted the Int32 value 1000 to the Decimal value 1000.
//    Converted the Int32 value 2147483647 to the Decimal value 2147483647.

Weitere Informationen

• Decimal

ToDecimal(Int16)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (short value);

Parameter

value

Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Beispiele

Im folgenden Beispiel wird ein Array von 16-Bit-Ganzzahlen mit Vorzeichen in Decimal Werte konvertiert.

short[] numbers = { Int16.MinValue, -1000, 0, 1000, Int16.MaxValue };
decimal result;

foreach (short number in numbers)
{
   result = Convert.ToDecimal(number);
   Console.WriteLine("Converted the Int16 value {0} to the Decimal value {1}.",
                     number, result);
}
// The example displays the following output:
//       Converted the Int16 value -32768 to the Decimal value -32768.
//       Converted the Int16 value -1000 to the Decimal value -1000.
//       Converted the Int16 value 0 to the Decimal value 0.
//       Converted the Int16 value 1000 to the Decimal value 1000.
//       Converted the Int16 value 32767 to the Decimal value 32767.

Weitere Informationen

• Decimal

ToDecimal(Double)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in eine entsprechende Dezimalzahl.

public static decimal ToDecimal (double value);

Parameter

value

Double

Die zu konvertierende Gleitkommazahl mit doppelter Genauigkeit.

Gibt zurück

Decimal

Eine Dezimalzahl, die value entspricht.

Ausnahmen

OverflowException

value ist größer als Decimal.MaxValue oder kleiner als Decimal.MinValue.

Beispiele

Im folgenden Beispiel wird ein Double Wert in einen Decimal Wert konvertiert.

public void ConvertDoubleDecimal(decimal decimalVal){
    
    double doubleVal;
    
    // Decimal to double conversion cannot overflow.
 doubleVal = System.Convert.ToDouble(decimalVal);
    System.Console.WriteLine("{0} as a double is: {1}",
            decimalVal, doubleVal);

    // Conversion from double to decimal can overflow.
    try
 {
       decimalVal = System.Convert.ToDecimal(doubleVal);
    System.Console.WriteLine ("{0} as a decimal is: {1}",
        doubleVal, decimalVal);
    }
    catch (System.OverflowException) {
        System.Console.WriteLine(
            "Overflow in double-to-double conversion.");
    }
}

Hinweise

Der Decimal von dieser Methode zurückgegebene Wert enthält maximal 15 signifikante Ziffern. Wenn der value Parameter mehr als 15 signifikante Ziffern enthält, wird er durch Rundung auf den nächsten gerundet. Im folgenden Beispiel wird veranschaulicht, wie die Convert.ToDecimal(Double) -Methode die Rundung auf den nächsten verwendet, um einen Decimal Wert mit 15 signifikanten Ziffern zurückzugeben.

Console.WriteLine(Convert.ToDecimal(123456789012345500.12D));  // Displays 123456789012346000
Console.WriteLine(Convert.ToDecimal(123456789012346500.12D));  // Displays 123456789012346000

Console.WriteLine(Convert.ToDecimal(10030.12345678905D));      // Displays 10030.123456789
Console.WriteLine(Convert.ToDecimal(10030.12345678915D));      // Displays 10030.1234567892

Weitere Informationen

• Double
• Round

ToDecimal(Decimal)

Quelle:

Convert.cs

Gibt die angegebene Dezimalzahl zurück. Es wird keine wirkliche Konvertierung durchgeführt.

public static decimal ToDecimal (decimal value);

Parameter

value

Decimal

Eine Dezimalzahl

Gibt zurück

Decimal

value wird unverändert zurückgegeben.

ToDecimal(DateTime)

Quelle:

Convert.cs

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

public static decimal ToDecimal (DateTime value);

Parameter

value

DateTime

Der Datums- und Uhrzeitwert, der konvertiert werden soll.

Gibt zurück

Decimal

Diese Konvertierung wird nicht unterstützt. Es wird kein Wert zurückgegeben.

Ausnahmen

InvalidCastException

Diese Konvertierung wird nicht unterstützt.

ToDecimal(Char)

Quelle:

Convert.cs

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

public static decimal ToDecimal (char value);

Parameter

value

Char

Das zu konvertierende Unicode-Zeichen.

Gibt zurück

Decimal

Diese Konvertierung wird nicht unterstützt. Es wird kein Wert zurückgegeben.

Ausnahmen

InvalidCastException

Diese Konvertierung wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird versucht, einen Char Wert in zu Decimalkonvertieren, und löst InvalidCastException bei einem Fehler aus.

public void ConvertCharDecimal(char charVal) {
    Decimal decimalVal = 0;
    
    // Char to decimal conversion is not supported and will always
    // throw an InvalidCastException.
    try {
        decimalVal = System.Convert.ToDecimal(charVal);
    }
    catch (System.InvalidCastException) {
        System.Console.WriteLine(
            "Char-to-Decimal conversion is not supported " +
            "by the .NET Framework.");
    }

    //Decimal to char conversion is also not supported.
    try {
        charVal = System.Convert.ToChar(decimalVal);
    }
    catch (System.InvalidCastException) {
        System.Console.WriteLine(
            "Decimal-to-Char conversion is not supported " +
            "by the .NET Framework.");
    }
}

Weitere Informationen

• Char

ToDecimal(Byte)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Dezimalzahl.

public static decimal ToDecimal (byte value);

Parameter

value

Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

Decimal

Die Dezimalzahl, die value entspricht.

Beispiele

Im folgenden Beispiel wird ein Byte Wert in einen Decimal Wert konvertiert.

public void ConvertByteDecimal(byte byteVal) {
    decimal decimalVal;

    // Byte to decimal conversion will not overflow.
    decimalVal = System.Convert.ToDecimal(byteVal);
    System.Console.WriteLine("The byte as a decimal is {0}.",
        decimalVal);

    // Decimal to byte conversion can overflow.
    try {
        byteVal = System.Convert.ToByte(decimalVal);
        System.Console.WriteLine("The Decimal as a byte is {0}.",
            byteVal);
    }
    catch (System.OverflowException) {
        System.Console.WriteLine(
            "The decimal value is too large for a byte.");
    }
}

Weitere Informationen

• Decimal

ToDecimal(Boolean)

Quelle:

Convert.cs

Konvertiert den angegebenen booleschen Wert in die entsprechende Dezimalzahl.

public static decimal ToDecimal (bool value);

Parameter

value

Boolean

Der zu konvertierende boolesche Wert.

Gibt zurück

Decimal

Die Zahl 1, wenn valuetrue ist, andernfalls 0 (null).

Beispiele

Im folgenden Beispiel wird die Konvertierung von Boolean in Decimal Werte veranschaulicht.

bool[] flags = { true, false };
decimal result;

foreach (bool flag in flags)
{
   result = Convert.ToDecimal(flag);
   Console.WriteLine("Converted {0} to {1}.", flag, result);
}
// The example displays the following output:
//       Converted True to 1.
//       Converted False to 0.

Weitere Informationen

• Decimal