System.InvalidCastException-klasse

.NET ondersteunt automatische conversie van afgeleide typen naar hun basistypen en weer terug naar het afgeleide type, evenals van typen die interfaces naar interface-objecten presenteren en terug. Het bevat ook verschillende mechanismen die aangepaste conversies ondersteunen. Zie Typeconversie in .NET voor meer informatie.

Er wordt een InvalidCastException uitzondering gegenereerd wanneer de conversie van een exemplaar van het ene type naar een ander type niet wordt ondersteund. Als u bijvoorbeeld een Char waarde probeert te converteren naar een DateTime waarde, wordt er een InvalidCastException uitzondering gegenereerd. Het verschilt van een OverflowException uitzondering, die wordt gegenereerd wanneer een conversie van het ene type naar het andere wordt ondersteund, maar de waarde van het brontype valt buiten het bereik van het doeltype. Een InvalidCastException uitzondering wordt veroorzaakt door een fout in de ontwikkelaar en mag niet worden verwerkt in een try/catch blok. In plaats daarvan moet de oorzaak van de uitzondering worden geëlimineerd.

Zie de Convert klasse voor informatie over conversies die door het systeem worden ondersteund. Zie de OverflowException uitzondering voor fouten die optreden wanneer het doeltype brontypewaarden kan opslaan, maar niet groot genoeg is om een specifieke bronwaarde op te slaan.

In de volgende secties worden enkele voorwaarden besproken waaronder een poging tot conversie een InvalidCastException uitzondering genereert.

Voor een expliciete conversie van verwijzingen moet de bronwaarde zijn null, of het objecttype waarnaar wordt verwezen door het bronargument moet worden geconverteerd naar het doeltype door een impliciete verwijzingsconversie.

Met de volgende instructies voor de tussenliggende taal (IL) wordt een InvalidCastException uitzondering gegenereerd:

• castclass
• refanyval
• unbox

InvalidCastException maakt gebruik van HRESULT COR_E_INVALIDCAST, met de waarde 0x80004002.

Voor een lijst van initiële eigenschapswaarden voor een exemplaar van InvalidCastException, zie de InvalidCastException-constructoren.

Primitieve typen en IConvertible

U roept direct of indirect de IConvertible-implementatie van een primitief type aan dat geen ondersteuning biedt voor een bepaalde conversie. Als u bijvoorbeeld een Boolean waarde wilt converteren naar een Char of een DateTime waarde naar een Int32 uitzondering, wordt er een InvalidCastException uitzondering gegenereerd. In het volgende voorbeeld worden zowel de Boolean.IConvertible.ToChar als Convert.ToChar(Boolean) de methoden aangeroepen om een Boolean waarde te converteren naar een Char. In beide gevallen genereert de methodeaanroep een InvalidCastException uitzondering.

using System;

public class IConvertibleEx
{
    public static void Main()
    {
        bool flag = true;
        try
        {
            IConvertible conv = flag;
            Char ch = conv.ToChar(null);
            Console.WriteLine("Conversion succeeded.");
        }
        catch (InvalidCastException)
        {
            Console.WriteLine("Cannot convert a Boolean to a Char.");
        }

        try
        {
            Char ch = Convert.ToChar(flag);
            Console.WriteLine("Conversion succeeded.");
        }
        catch (InvalidCastException)
        {
            Console.WriteLine("Cannot convert a Boolean to a Char.");
        }
    }
}
// The example displays the following output:
//       Cannot convert a Boolean to a Char.
//       Cannot convert a Boolean to a Char.

open System

let flag = true
try
    let conv: IConvertible = flag
    let ch = conv.ToChar null
    printfn "Conversion succeeded."
with :? InvalidCastException ->
    printfn "Cannot convert a Boolean to a Char."

try
    let ch = Convert.ToChar flag
    printfn "Conversion succeeded."
with :? InvalidCastException ->
    printfn "Cannot convert a Boolean to a Char."

// The example displays the following output:
//       Cannot convert a Boolean to a Char.
//       Cannot convert a Boolean to a Char.

Module Example2
    Public Sub Main()
        Dim flag As Boolean = True
        Try
            Dim conv As IConvertible = flag
            Dim ch As Char = conv.ToChar(Nothing)
            Console.WriteLine("Conversion succeeded.")
        Catch e As InvalidCastException
            Console.WriteLine("Cannot convert a Boolean to a Char.")
        End Try

        Try
            Dim ch As Char = Convert.ToChar(flag)
            Console.WriteLine("Conversion succeeded.")
        Catch e As InvalidCastException
            Console.WriteLine("Cannot convert a Boolean to a Char.")
        End Try
    End Sub
End Module
' The example displays the following output:
'       Cannot convert a Boolean to a Char.
'       Cannot convert a Boolean to a Char.

Omdat de conversie niet wordt ondersteund, is er geen tijdelijke oplossing.

De methode Convert.ChangeType

U hebt de Convert.ChangeType methode aangeroepen om een object van het ene type naar het andere te converteren, maar een of beide typen implementeren de IConvertible interface niet.

In de meeste gevallen is er geen tijdelijke oplossing omdat de conversie niet wordt ondersteund. In sommige gevallen is een mogelijke tijdelijke oplossing het handmatig toewijzen van eigenschapswaarden van het brontype aan vergelijkbare eigenschappen van een doeltype.

Conversies en IConvertible-implementaties beperken

Narrowing operators definiëren de expliciete conversies die door een type ondersteund worden. Een cast-operator in C# of de CType conversiemethode in Visual Basic (indien Option Strict ingeschakeld) is vereist om de conversie uit te voeren.

Als echter noch het brontype noch het doeltype een expliciete of beperkte conversie tussen de twee typen definieert en de IConvertible implementatie van een of beide typen geen conversie van het brontype naar het doeltype ondersteunt, wordt er een InvalidCastException uitzondering gegenereerd.

In de meeste gevallen is er geen tijdelijke oplossing omdat de conversie niet wordt ondersteund.

Typeverlaging

U bent aan het downcasten, dat wil zeggen, een instantie van een basistype naar een van zijn afgeleide typen converteren. In het volgende voorbeeld mislukt het converteren van een Person object naar een PersonWithID object.

using System;

public class Person
{
   String _name;

   public String Name
   {
      get { return _name; }
      set { _name = value; }
   }
}

public class PersonWithId : Person
{
   String _id;

   public string Id
   {
      get { return _id; }
      set { _id = value; }
   }
}

public class Example
{
   public static void Main()
   {
      Person p = new Person();
      p.Name = "John";
      try {
         PersonWithId pid = (PersonWithId) p;
         Console.WriteLine("Conversion succeeded.");
      }
      catch (InvalidCastException) {
         Console.WriteLine("Conversion failed.");
      }

      PersonWithId pid1 = new PersonWithId();
      pid1.Name = "John";
      pid1.Id = "246";
      Person p1 = pid1;
      try {
         PersonWithId pid1a = (PersonWithId) p1;
         Console.WriteLine("Conversion succeeded.");
      }
      catch (InvalidCastException) {
         Console.WriteLine("Conversion failed.");
      }

      Person p2 = null;
      try {
         PersonWithId pid2 = (PersonWithId) p2;
         Console.WriteLine("Conversion succeeded.");
      }
      catch (InvalidCastException) {
         Console.WriteLine("Conversion failed.");
      }
   }
}
// The example displays the following output:
//       Conversion failed.
//       Conversion succeeded.
//       Conversion succeeded.

open System

type Person() =
    member val Name = String.Empty with get, set

type PersonWithId() =
    inherit Person()
    member val Id = String.Empty with get, set


let p = Person()
p.Name <- "John"
try
    let pid = p :?> PersonWithId
    printfn "Conversion succeeded."
with :? InvalidCastException ->
    printfn "Conversion failed."

let pid1 = PersonWithId()
pid1.Name <- "John"
pid1.Id <- "246"
let p1: Person = pid1
try
    let pid1a = p1 :?> PersonWithId
    printfn "Conversion succeeded."
with :? InvalidCastException ->
    printfn "Conversion failed."

// The example displays the following output:
//       Conversion failed.
//       Conversion succeeded.

Public Class Person
   Dim _name As String
   
   Public Property Name As String
      Get
         Return _name
      End Get
      Set
         _name = value
      End Set
   End Property
End Class

Public Class PersonWithID : Inherits Person
   Dim _id As String
   
   Public Property Id As String
      Get
         Return _id
      End Get
      Set
         _id = value
      End Set
   End Property
End Class

Module Example1
    Public Sub Main()
        Dim p As New Person()
        p.Name = "John"
        Try
            Dim pid As PersonWithID = CType(p, PersonWithID)
            Console.WriteLine("Conversion succeeded.")
        Catch e As InvalidCastException
            Console.WriteLine("Conversion failed.")
        End Try

        Dim pid1 As New PersonWithID()
        pid1.Name = "John"
        pid1.Id = "246"
        Dim p1 As Person = pid1

        Try
            Dim pid1a As PersonWithID = CType(p1, PersonWithID)
            Console.WriteLine("Conversion succeeded.")
        Catch e As InvalidCastException
            Console.WriteLine("Conversion failed.")
        End Try

        Dim p2 As Person = Nothing
        Try
            Dim pid2 As PersonWithID = CType(p2, PersonWithID)
            Console.WriteLine("Conversion succeeded.")
        Catch e As InvalidCastException
            Console.WriteLine("Conversion failed.")
        End Try
    End Sub
End Module
' The example displays the following output:
'       Conversion failed.
'       Conversion succeeded.
'       Conversion succeeded.

Zoals in het voorbeeld wordt weergegeven, slaagt de downcast alleen als het Person object is gemaakt door een upcast van een PersonWithId object naar een Person object of als het Person object is null.

Conversie van een interfaceobject

U probeert een interfaceobject te converteren naar een type dat die interface implementeert, maar het doeltype is niet hetzelfde type of een basisklasse van het type waaruit het interfaceobject oorspronkelijk is afgeleid. Het volgende voorbeeld werpt een InvalidCastException uitzondering wanneer het probeert een IFormatProvider object naar een DateTimeFormatInfo object te converteren. De conversie mislukt omdat hoewel de DateTimeFormatInfo klasse de IFormatProvider interface implementeert, het DateTimeFormatInfo object niet is gerelateerd aan de CultureInfo klasse waaruit het interfaceobject is afgeleid.

using System;
using System.Globalization;

public class InterfaceEx
{
    public static void Main()
    {
        var culture = CultureInfo.InvariantCulture;
        IFormatProvider provider = culture;

        DateTimeFormatInfo dt = (DateTimeFormatInfo)provider;
    }
}
// The example displays the following output:
//    Unhandled Exception: System.InvalidCastException:
//       Unable to cast object of type //System.Globalization.CultureInfo// to
//           type //System.Globalization.DateTimeFormatInfo//.
//       at Example.Main()

open System
open System.Globalization

let culture = CultureInfo.InvariantCulture
let provider: IFormatProvider = culture

let dt = provider :?> DateTimeFormatInfo

// The example displays the following output:
//    Unhandled Exception: System.InvalidCastException:
//       Unable to cast object of type //System.Globalization.CultureInfo// to
//           type //System.Globalization.DateTimeFormatInfo//.
//       at Example.main()

Imports System.Globalization

Module Example3
    Public Sub Main()
        Dim culture As CultureInfo = CultureInfo.InvariantCulture
        Dim provider As IFormatProvider = culture

        Dim dt As DateTimeFormatInfo = CType(provider, DateTimeFormatInfo)
    End Sub
End Module
' The example displays the following output:
'    Unhandled Exception: System.InvalidCastException: 
'       Unable to cast object of type 'System.Globalization.CultureInfo' to 
'           type 'System.Globalization.DateTimeFormatInfo'.
'       at Example.Main()

Zoals het uitzonderingsbericht aangeeft, slaagt de conversie alleen als het interfaceobject wordt teruggezet naar een exemplaar van het oorspronkelijke type, in dit geval een CultureInfo. De conversie zou ook slagen als het interfaceobject wordt geconverteerd naar een exemplaar van een basistype van het oorspronkelijke type.

Tekenreeksconversies

U probeert een waarde of object te converteren naar de tekenreeksweergave met behulp van een cast-operator in C#. In het volgende voorbeeld genereert zowel de poging om een Char waarde naar een tekenreeks te casten als de poging om een geheel getal naar een tekenreeks te casten een InvalidCastException uitzondering.

public class StringEx
{
    public static void Main()
    {
        object value = 12;
        // Cast throws an InvalidCastException exception.
        string s = (string)value;
    }
}

let value: obj = 12
// Cast throws an InvalidCastException exception.
let s = value :?> string

Als u een object van een willekeurig type wilt converteren naar de tekenreeksweergave, roept u de ToString methode aan, zoals het volgende voorbeeld doet. De ToString methode is altijd aanwezig, omdat de ToString methode wordt gedefinieerd door de Object klasse en daarom wordt overgenomen of overschreven door alle beheerde typen.

using System;

public class ToStringEx2
{
    public static void Main()
    {
        object value = 12;
        string s = value.ToString();
        Console.WriteLine(s);
    }
}
// The example displays the following output:
//      12

let value: obj = 12
let s = value.ToString()
printfn $"{s}"
// The example displays the following output:
//      12

Visual Basic 6.0-migratie

U voert een upgrade uit van een Visual Basic 6.0-toepassing met een aanroep naar een aangepaste gebeurtenis in een gebruikersbeheer naar Visual Basic .NET. Er wordt een InvalidCastException uitzondering gegenereerd met het bericht 'Opgegeven cast is ongeldig'. Als u deze uitzondering wilt elimineren, wijzigt u de coderegel in uw formulier (zoals Form1)

Call UserControl11_MyCustomEvent(UserControl11, New UserControl1.MyCustomEventEventArgs(5))

en vervang deze door de volgende coderegel:

Call UserControl11_MyCustomEvent(UserControl11(0), New UserControl1.MyCustomEventEventArgs(5))