Convert-Klasse

Es gibt eine Konvertierungsmethode, mit der jeder Basistyp in jeden anderen Basistyp konvertiert werden kann. Das tatsächliche Aufrufen einer bestimmten Konvertierungsmethode kann jedoch zu einem von fünf Ergebnissen führen, abhängig vom Wert des Basistyps zur Laufzeit und des Zielbasistyps. Diese fünf Ergebnisse lauten wie folgt:

• Keine Konvertierung. Dies tritt auf, wenn versucht wird, von einem Typ in den gleichen Typ zu konvertieren (z. B. durch Aufrufen von Convert.ToInt32(Int32) mit einem Argument vom Typ Int32). In diesem Fall gibt die Methode einfach eine Instanz des ursprünglichen Typs zurück.

• Ein InvalidCastException. Dies tritt auf, wenn eine bestimmte Konvertierung nicht unterstützt wird. Für die folgenden Konvertierungen wird eine InvalidCastException ausgelöst:

  • Konvertierungen von Char in Boolean, Single, Double, Decimal oder DateTime.

  • Konvertierungen von Boolean, Single, Double, Decimal oder DateTime in Char.

  • Konvertierungen von DateTime in einem anderen Typ, mit Ausnahme von String.

  • Konvertierungen von einem anderen Typ, mit Ausnahme von String, in DateTime.

• FormatException Tritt ein, wenn bei dem Versuch, einen Zeichenfolgenwert in einen beliebigen anderen Basistyp zu konvertieren, ein Fehler auftritt, da die Zeichenfolge nicht das richtige Format aufweist. Die Ausnahme wird für die folgenden Konvertierungen ausgelöst:

  • Eine Zeichenfolge, die zu einem Boolean-Wert konvertiert werden soll, entspricht nicht Boolean.TrueString oder Boolean.FalseString.

  • Eine Zeichenfolge, die in einen Char-Wert konvertiert werden soll, besteht aus mehreren Zeichen.

  • Eine Zeichenfolge, die in einen beliebigen numerischen Typ konvertiert werden soll, wird nicht als gültige Zahl erkannt.

  • Eine Zeichenfolge, die in einen DateTime-Wert konvertiert werden soll, wird nicht als gültiger Datums- und Uhrzeitwert erkannt.

• Eine erfolgreiche Konvertierung. Bei Konvertierungen zwischen unterschiedlichen Basistypen, die nicht unter den oben genannten Ergebnissen aufgeführt wurden, sind alle erweiternde Konvertierungen sowie einschränkenden Konvertierungen, die nicht zu einem Datenverlust führen, erfolgreich, und die Methode gibt einen Wert mit dem gewünschten Basistyp zurück.

• Ein OverflowException. Dies tritt auf, wenn eine einschränkende Konvertierung zu einem Datenverlust führt. Wenn Sie z. B. versuchen, eine Int32-Instanz mit dem Wert 10000 in einen Byte-Typ zu konvertieren, wird eine OverflowException ausgelöst, da 10000 sich außerhalb des Bereichs des Byte-Datentyps befindet.

Es wird keine Ausnahme ausgelöst, wenn die Konvertierung eines numerischen Typs zu einem Genauigkeitsverlust (d. h. zum Verlust eines Teiles der am wenigsten signifikanten Ziffern) führt. Allerdings wird eine Ausnahme ausgelöst, wenn das Ergebnis so groß ist, dass es nicht durch den Typ des Rückgabewerts dieser speziellen Konvertierungsmethode dargestellt werden kann.

Wenn z. B. ein Double in einen Single konvertiert wird, kann ein Genauigkeitsverlust auftreten, aber es wird keine Ausnahme ausgelöst. Wenn der Double allerdings so groß ist, dass er nicht als Single dargestellt werden kann, wird eine Ausnahme wegen Überlaufs ausgelöst.

Zusätzlich zu Konvertierungen zwischen den Basistypen unterstützt die Convert-Methode die Konvertierung von beliebigen benutzerdefinierten Typen in beliebige Basistypen. Hierzu muss der benutzerdefinierte Typ die IConvertible-Schnittstelle implementieren, die Methoden zum Konvertieren des implementierenden Typs in jeden der Basistypen definiert. Konvertierungen, die nicht von einem bestimmten Typ unterstützt werden, sollten eine InvalidCastException auslösen.

Wenn der ChangeType-Methode ein benutzerdefinierter Typ als erster Parameter übergeben wird oder wenn die Convert.ToType-Methode, z. B. Convert.ToInt32(Object) oder Convert.ToDouble(Object, IFormatProvider), aufgerufen wird und eine Instanz eines benutzerdefinierten Typs als ersten Parameter übergibt, ruft die Convert-Methode wiederum die IConvertible-Implementierung des benutzerdefinierten Typs auf, um die Konvertierung auszuführen. Weitere Informationen finden Sie unter Typkonvertierung in .NET Framework.

Alle Basistypkonvertierungsmethoden und die ChangeType-Methode enthalten Überladungen, die über einen Parameter des Typs IFormatProvider verfügen. Die Convert.ToBoolean-Methode besitzt z. B. die folgenden beiden Überladungen:

• Convert.ToBoolean(Object, IFormatProvider)

• Convert.ToBoolean(String, IFormatProvider)

Der IFormatProvider-Parameter kann beim Konvertierungsvorgang hilfreiche kulturabhängige Formatierungsinformationen liefern. Er wird jedoch von den meisten der Basistypkonvertierungsmethoden ignoriert. Er wird nur von den folgenden Basistypkonvertierungsmethoden verwendet:

• Von Methoden, die einen Wert in einen numerischen Typ konvertieren. Der IFormatProvider-Parameter wird von der Überladung verwendet, die über Parameter vom Typ String und IFormatProvider verfügt. Er wird auch von der Überladung verwendet, die über Parameter vom Typ Object und IFormatProvider verfügt, wenn der Laufzeittyp des Objekts ein String ist.

• Von Methoden, die einen Wert in ein Datum und eine Uhrzeit konvertieren. Der IFormatProvider-Parameter wird von der Überladung verwendet, die über Parameter vom Typ String und IFormatProvider verfügt. Er wird auch von der Überladung verwendet, die über Parameter vom Typ Object und IFormatProvider verfügt, wenn der Laufzeittyp des Objekts ein String ist.

• Von den Convert.ToString-Überladungen, die entweder einen numerischen Wert in eine Zeichenfolge oder einen DateTime-Wert in eine Zeichenfolge konvertieren und einen IFormatProvider-Parameter enthalten.

Jeder benutzerdefinierte Typ, der IConvertible implementiert, kann jedoch den IFormatProvider-Parameter nutzen.

Eine Gruppe von Methoden unterstützt das Konvertieren zwischen einem Bytearray und einem String oder einem Array von Unicode-Zeichen, die aus Base-64-Ziffernzeichen bestehen. Als Base-64-Ziffern dargestellte Daten können bequem über Datenchannels übermittelt werden, die nur 7-Bit-Zeichen übertragen können.