InvalidCastException Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wyjątek zgłaszany dla nieprawidłowej konwersji rzutowej lub jawnej.

public ref class InvalidCastException : Exception

public ref class InvalidCastException : SystemException

public class InvalidCastException : Exception

public class InvalidCastException : SystemException

[System.Serializable]
public class InvalidCastException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class InvalidCastException : SystemException

type InvalidCastException = class
    inherit Exception

type InvalidCastException = class
    inherit SystemException

[<System.Serializable>]
type InvalidCastException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type InvalidCastException = class
    inherit SystemException

Public Class InvalidCastException
Inherits Exception

Public Class InvalidCastException
Inherits SystemException

Dziedziczenie: Object

Exception
InvalidCastException

Dziedziczenie: Object

Exception

SystemException
InvalidCastException

Atrybuty: SerializableAttribute ComVisibleAttribute

Uwagi

.NET Framework 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 w .NET Framework.

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 konwersja jednego typu na inny jest obsługiwana, 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 nie istnieje konwersja między typem źródłowym a typem docelowym i wystawia błąd kompilatora.

Niektóre warunki, w których podjęto próbę InvalidCastException konwersji zgłasza wyjątek, zostały omówione w następujących sekcjach:

Typy pierwotne i IConvertible
Metoda Convert.ChangeType
Zawężanie konwersji i implementacji IConvertible
Obniżanie emisji
Konwersja z obiektu interfejsu
Konwersje ciągów
migracja Visual Basic 6.0

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 COR_E_INVALIDCAST HRESULT, który ma wartość 0x80004002.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia programu InvalidCastException, 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 Int32 zgłasza InvalidCastException wyjątek. Poniższy przykład wywołuje metody Boolean.IConvertible.ToChar i , Convert.ToChar(Boolean) aby przekonwertować Boolean wartość na wartość Char. W obu przypadkach wywołanie metody zgłasza InvalidCastException wyjątek.

using System;

public class Example
{
   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 Example
   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.

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.

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 Example
   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, emisja w dół powiedzie się tylko wtedy, gdy Person obiekt został utworzony przez emisję upcast z PersonWithId obiektu do Person obiektu lub jeśli Person obiekt to null.

Konwersja z obiektu interfejsu

Próbujesz przekonwertować obiekt interfejsu na typ implementujący ten interfejs, ale typ docelowy nie jest tym samym typem 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ż chociaż DateTimeFormatInfo klasa implementuje IFormatProvider interfejs, DateTimeFormatInfo obiekt nie jest powiązany z CultureInfo klasą, z której pochodzi obiekt interfejsu.

using System;
using System.Globalization;

public class Example
{
   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 Example
   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 obiekt interfejsu zostanie przekonwertowany na wystąpienie podstawowego typu oryginalnego.

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 InvalidCastException wyjątek.

using System;

public class Example
{
   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

Użycie operatora 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 Example
{
   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 Visual Basic 6.0

Uaktualniasz aplikację Visual Basic 6.0 z wywołaniem zdarzenia niestandardowego w kontrolce użytkownika w celu Visual Basic .NET, a InvalidCastException wyjątek 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))

Konstruktory

InvalidCastException()	Inicjuje nowe wystąpienie klasy InvalidCastException.
InvalidCastException(SerializationInfo, StreamingContext)	Inicjuje nowe wystąpienie klasy InvalidCastException z zserializowanymi danymi.
InvalidCastException(String)	Inicjuje InvalidCastException nowe wystąpienie klasy z określonym komunikatem o błędzie.
InvalidCastException(String, Exception)	Inicjuje nowe wystąpienie InvalidCastException klasy z określonym komunikatem o błędzie i odwołaniem do wewnętrznego wyjątku, który jest przyczyną tego wyjątku.
InvalidCastException(String, Int32)	Inicjuje InvalidCastException nowe wystąpienie klasy z określonym komunikatem i kodem błędu.

Właściwości

Data	Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception)
HelpLink	Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception)
HResult	Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception)
InnerException	Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception)
Message	Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception)
Source	Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception)
StackTrace	Pobiera reprezentację ciągu natychmiastowych ramek w stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaseException()	Po przesłonięciu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Po zastąpieniu w klasie pochodnej ustawia SerializationInfo element z informacjami o wyjątku. (Odziedziczone po Exception)
GetType()	Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Nieaktualne.

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane o wyjątku.

(Odziedziczone po Exception)

Dotyczy