Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


System.InvalidCastException, klasa

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, które przedstawiają interfejsy do obiektów interfejsu 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, ale wartość typu źródłowego znajduje się poza zakresem typu docelowego. Wyjątek InvalidCastException jest spowodowany błędem dewelopera try/catch i nie powinien być obsługiwany w bloku. 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

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

Niektóre warunki, w których podjęto próbę InvalidCastException konwersji zgłasza wyjątek, 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 InvalidCastExceptionprogramu , zobacz InvalidCastException konstruktory.

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 i Convert.ToChar(Boolean) , Boolean.IConvertible.ToChar aby przekonwertować Boolean wartość na Charwartość . 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.

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

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

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

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 Person obiektu na obiekt kończy się niepowodzeniem PersonWithID .

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.

Jak pokazano w przykładzie, downcast kończy się powodzeniem tylko wtedy, gdy Person obiekt został utworzony przez emisję upcast z PersonWithId obiektu do Person obiektu lub jeśli Person obiekt ma wartość 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 CultureInfo klasą, DateTimeFormatInfo 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()

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 obiekt interfejsu zostanie przekonwertowany na wystąpienie typu podstawowego 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;
    }
}

Uwaga

Użycie operatora Języka Visual Basic CStr w celu przekonwertowania wartości typu pierwotnego na ciąg powiedzie się. 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

Migracja programu Visual Basic 6.0

Uaktualniasz aplikację języka Visual Basic 6.0 z wywołaniem zdarzenia niestandardowego w kontrolce użytkownika do platformy .NET języka Visual Basic, a wyjątek InvalidCastException jest zgłaszany z komunikatem "Określona rzutowanie jest nieprawidłowa". 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))