Udostępnij za pomocą

klasa System.InvalidCastException

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

Platforma .NET obsługuje automatyczną konwersję z typów pochodnych na ich typy podstawowe i z powrotem do typu pochodnego, a także z typów zawierających interfejsy na obiekty interfejsowe i z powrotem. Zawiera również różne mechanizmy, które obsługują konwersje niestandardowe. Aby uzyskać więcej informacji, zobacz Konwersja typów na platformie .NET.

Wyjątek InvalidCastException jest zgłaszany, gdy konwersja wystąpienia jednego typu na inny typ nie jest obsługiwana. Na przykład próba przekonwertowania Char wartości na DateTime wartość zgłasza InvalidCastException wyjątek. Różni się on od OverflowException wyjątku, który jest zgłaszany, gdy jest obsługiwana konwersja jednego typu na inny typ, ale wartość typu źródłowego znajduje się poza dozwolonym zakresem typu docelowego. Wyjątek InvalidCastException jest spowodowany błędem dewelopera i nie należy go obsługiwać w bloku try/catch. Zamiast tego należy wyeliminować przyczynę wyjątku.

Aby uzyskać informacje na temat konwersji obsługiwanych przez system, zobacz klasę Convert . W przypadku błędów występujących, gdy typ docelowy może przechowywać wartości typu źródłowego, ale nie jest wystarczająco duży, aby przechowywać określoną wartość źródłową, zobacz OverflowException wyjątek.

Uwaga / Notatka

W wielu przypadkach kompilator języka wykrywa, że nie istnieje żadna konwersja między typem źródłowym a typem docelowym i zgłasza błąd kompilatora.

Niektóre z warunków, w których próba konwersji zgłasza wyjątek InvalidCastException, zostały omówione w poniższych sekcjach.

Aby jawna konwersja odwołania zakończyła się pomyślnie, wartość źródłowa musi mieć nullwartość lub typ obiektu, do którego odwołuje się argument źródłowy, musi być konwertowany na typ docelowy przez niejawną konwersję odwołania.

Następujące instrukcje języka pośredniego (IL) zgłaszają InvalidCastException wyjątek:

  • castclass
  • refanyval
  • unbox

InvalidCastException używa hrESULT COR_E_INVALIDCAST, który ma wartość 0x80004002.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia InvalidCastException, zapoznaj się z konstruktorami InvalidCastException.

Typy pierwotne i IConvertible

Bezpośrednio lub pośrednio wywołujesz implementację typu IConvertible pierwotnego, która nie obsługuje określonej konwersji. Na przykład próba przekonwertowania Boolean wartości na Char wartość lub DateTime na Int32InvalidCastException zgłasza wyjątek. Poniższy przykład wywołuje metody Boolean.IConvertible.ToChar i Convert.ToChar(Boolean), aby przekonwertować wartość Boolean na wartość Char. W obu przypadkach wywołanie metody zgłasza InvalidCastException wyjątek.

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.

Ponieważ konwersja nie jest obsługiwana, nie ma obejścia problemu.

Metoda Convert.ChangeType

Wywołaliśmy metodę Convert.ChangeType , aby przekonwertować obiekt z jednego typu na inny, ale jeden lub oba typy nie implementują interfejsu IConvertible .

W większości przypadków, ponieważ konwersja nie jest obsługiwana, nie ma obejścia. W niektórych przypadkach możliwe obejście polega na ręcznym przypisaniu wartości właściwości z typu źródłowego do podobnych właściwości typu docelowego.

Zawężanie konwersji i implementacje IConvertible

Operatory zawężania definiują jawne konwersje obsługiwane przez typ. Operator rzutowania w języku C# lub metoda konwersji w języku Visual Basic (jeśli CType jest włączona) są wymagane do przeprowadzenia konwersji.

Jeśli jednak ani typ źródłowy, ani typ docelowy nie definiują konwersji jawnej ani zawężającej między tymi typami, a implementacja IConvertible jednego lub obu typów nie obsługuje konwersji z typu źródłowego na typ docelowy, zgłaszany jest wyjątek InvalidCastException.

W większości przypadków, ponieważ konwersja nie jest obsługiwana, nie ma obejścia.

Obniżanie emisji

Obniżasz, czyli próbujesz przekonwertować wystąpienie typu podstawowego na jeden z jego typów pochodnych. W poniższym przykładzie próba przekonwertowania obiektu Person na obiekt PersonWithID kończy się niepowodzeniem.

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.

Jak pokazano w przykładzie, rzutowanie w dół kończy się powodzeniem tylko wtedy, gdy Person obiekt został utworzony przez rzutowanie w górę z PersonWithId obiektu na Person obiekt, lub gdy Person obiekt jest null.

Konwersja z obiektu interfejsu

Próbujesz przekonwertować obiekt interfejsu na typ implementujący ten interfejs, ale typ docelowy nie jest tego samego typu lub klasą bazową typu, z którego pierwotnie pochodzi obiekt interfejsu. Poniższy przykład zgłasza InvalidCastException wyjątek podczas próby przekonwertowania IFormatProvider obiektu na DateTimeFormatInfo obiekt. Konwersja kończy się niepowodzeniem, ponieważ mimo że DateTimeFormatInfo klasa implementuje IFormatProvider interfejs, obiekt nie jest powiązany z DateTimeFormatInfo klasą, CultureInfo z której pochodzi obiekt interfejsu.

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

Jak wskazuje komunikat o wyjątku, konwersja powiedzie się tylko wtedy, gdy obiekt interfejsu zostanie przekonwertowany z powrotem na wystąpienie oryginalnego typu, w tym przypadku CultureInfo. Konwersja powiedzie się również, jeśli zostanie przekonwertowany obiekt interfejsu na wystąpienie typu bazowego oryginalnego typu.

Konwersje ciągów

Próbujesz przekonwertować wartość lub obiekt na jego reprezentację ciągu przy użyciu operatora rzutowania w języku C#. W poniższym przykładzie zarówno próba rzutowania Char wartości na ciąg, jak i próba rzutowania liczby całkowitej na ciąg zgłasza wyjątek InvalidCastException .

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

Uwaga / Notatka

Użycie operatora języka Visual Basic CStr w celu przekonwertowania wartości typu pierwotnego na ciąg zakończy się powodzeniem. Operacja nie zgłasza wyjątku InvalidCastException .

Aby pomyślnie przekonwertować wystąpienie dowolnego typu na reprezentację ciągu, wywołaj metodę ToString , jak w poniższym przykładzie. Metoda ToString jest zawsze obecna, ponieważ ToString metoda jest definiowana przez klasę Object i dlatego jest dziedziczona lub zastępowana przez wszystkie typy zarządzane.

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

Migracja programu Visual Basic 6.0

Uaktualniasz aplikację w języku Visual Basic 6.0 z wywołaniem zdarzenia niestandardowego w kontrolce użytkownika do Visual Basic .NET, a wyjątek InvalidCastException jest zgłaszany z komunikatem "Określone rzutowanie jest nieprawidłowe". Aby wyeliminować ten wyjątek, zmień wiersz kodu w formularzu (na przykład Form1)

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

zastąp go następującym wierszem kodu:

Call UserControl11_MyCustomEvent(UserControl11(0), New UserControl1.MyCustomEventEventArgs(5))
  • Last updated on