InvalidCastException Класс

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Исключение, которое выдается в случае недопустимого приведения или явного преобразования.

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

Наследование: Object

Exception
InvalidCastException

Наследование: Object

Exception

SystemException
InvalidCastException

Атрибуты: SerializableAttribute ComVisibleAttribute

платформа .NET Framework поддерживает автоматическое преобразование производных типов в базовые типы и обратно в производный тип, а также из типов, которые представляют интерфейсы для объектов интерфейса и обратно. Он также включает различные механизмы, поддерживающие пользовательские преобразования. Дополнительные сведения см. в разделе "Преобразование типов" в платформа .NET Framework.

Исключение InvalidCastException возникает, когда преобразование экземпляра одного типа в другой тип не поддерживается. Например, при попытке преобразовать Char значение в DateTime значение возникает InvalidCastException исключение. Он отличается от OverflowException исключения, которое возникает при поддержке преобразования одного типа в другой, но значение исходного типа выходит за пределы диапазона целевого типа. Исключение InvalidCastException вызвано ошибкой разработчика и не должно обрабатываться в блоке try/catch . Вместо этого следует устранить причину исключения.

Сведения о преобразованиях, поддерживаемых системой, см. в Convert классе. Сведения об ошибках, возникающих, когда целевой тип может хранить значения исходного типа, но недостаточно велик для хранения определенного исходного значения, см OverflowException . исключение.

Примечание

Во многих случаях компилятор языка обнаруживает, что преобразование между исходным типом и целевым типом не существует, и выдает ошибку компилятора.

Некоторые условия, при которых попытка преобразования создает InvalidCastException исключение, рассматриваются в следующих разделах:

Примитивные типы и IConvertible
Метод Convert.ChangeType
Сужение преобразований и реализаций IConvertible
Понижение трансляции
Преобразование из объекта интерфейса
Преобразование строк
миграция Visual Basic 6.0

Для успешного явного преобразования ссылок исходное значение должно быть nullравно или тип объекта, на который ссылается исходный аргумент, должен быть преобразован в тип назначения путем неявного преобразования ссылок.

Следующие инструкции промежуточного языка (IL) вызывают InvalidCastException исключение:

castclass
refanyval
unbox

InvalidCastException использует COR_E_INVALIDCAST HRESULT, имеющий значение 0x80004002.

Список начальных значений свойств для экземпляра InvalidCastException, см. в разделе InvalidCastException конструкторы.

Примитивные типы и IConvertible

Вы напрямую или косвенно вызываете реализацию примитива типа IConvertible , которая не поддерживает определенное преобразование. Например, при попытке преобразовать Boolean значение в значение Char или DateTime значение вызывается Int32 InvalidCastException исключение. В следующем примере вызывается как метод, Boolean.IConvertible.ToChar так и Convert.ToChar(Boolean) методы для преобразования Boolean значения в .Char В обоих случаях вызов метода создает InvalidCastException исключение.

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.

Так как преобразование не поддерживается, обходное решение отсутствует.

Метод Convert.ChangeType

Вы вызвали Convert.ChangeType метод для преобразования объекта из одного типа в другой, но один или оба типа не реализуют IConvertible интерфейс.

В большинстве случаев, так как преобразование не поддерживается, обходное решение не существует. В некоторых случаях возможным обходным решением является ручное назначение значений свойств исходного типа аналогичным свойствам целевого типа.

Сужение преобразований и реализаций IConvertible

Сужающие операторы определяют явные преобразования, поддерживаемые типом. Для выполнения преобразования требуется оператор приведения в C# или CType метод преобразования в Visual Basic (если Option Strict он включен).

Однако если ни исходный тип, ни целевой тип не определяют явное или сужающее преобразование между двумя типами, а IConvertible реализация одного или обоих типов не поддерживает преобразование из исходного типа в целевой тип, InvalidCastException создается исключение.

В большинстве случаев, так как преобразование не поддерживается, обходное решение не существует.

Понижение трансляции

Вы выполняете понижение, то есть пытаетесь преобразовать экземпляр базового типа в один из его производных типов. В следующем примере попытка преобразовать Person объект в объект завершается ошибкой 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.

Как показано в примере, даунка выполняется успешно только в том случае, если Person объект был создан путем переадресации из PersonWithId объекта Person в объект или если Person объект имеет значение null.

Преобразование из объекта интерфейса

Вы пытаетесь преобразовать объект интерфейса в тип, реализующий этот интерфейс, но целевой тип не совпадает с типом или базовым классом типа, от которого объект интерфейса был изначально производным. В следующем примере возникает InvalidCastException исключение при попытке преобразовать IFormatProvider объект в DateTimeFormatInfo объект. Преобразование завершается ошибкой, так как хотя DateTimeFormatInfo класс реализует IFormatProvider интерфейс, объект не связан с CultureInfo классом, DateTimeFormatInfo из которого был получен объект интерфейса.

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

Как указано в сообщении об исключении, преобразование будет выполнено успешно только в том случае CultureInfo, если объект интерфейса преобразуется обратно в экземпляр исходного типа. Преобразование также будет выполнено, если объект интерфейса преобразуется в экземпляр базового типа исходного типа.

Преобразование строк

Вы пытаетесь преобразовать значение или объект в строковое представление с помощью оператора приведения в C#. В следующем примере попытка приведения Char значения к строке и попытка приведения целого числа к строке InvalidCastException вызывает исключение.

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

Примечание

Использование оператора Visual Basic CStr для преобразования значения примитива типа в строку завершается успешно. Операция не создает InvalidCastException исключение.

Чтобы успешно преобразовать экземпляр любого типа в строковое представление, вызовите его ToString метод, как показано в следующем примере. Метод ToString всегда присутствует, так как ToString метод определяется классом Object и, следовательно, наследуется или переопределяется всеми управляемыми типами.

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

миграция Visual Basic 6.0

Вы обновляете приложение Visual Basic 6.0 с вызовом настраиваемого события в пользовательском элементе управления, чтобы Visual Basic .NET, а InvalidCastException исключение создается с сообщением "Указанный приведение недопустим". Чтобы исключить это исключение, измените строку кода в форме (например Form1)

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

и замените его следующей строкой кода:

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

Конструкторы

InvalidCastException()	Инициализирует новый экземпляр класса InvalidCastException.
InvalidCastException(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр класса InvalidCastException с сериализованными данными.
InvalidCastException(String)	Инициализирует новый экземпляр класса InvalidCastException с указанным сообщением об ошибке.
InvalidCastException(String, Exception)	Инициализирует новый экземпляр класса InvalidCastException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.
InvalidCastException(String, Int32)	Инициализирует новый экземпляр класса InvalidCastException, используя заданное сообщение и код ошибки.

Свойства

Data	Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. (Унаследовано от Exception)
HelpLink	Получает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр класса Exception, который вызвал текущее исключение. (Унаследовано от Exception)
Message	Возвращает сообщение, описывающее текущее исключение. (Унаследовано от Exception)
Source	Возвращает или задает имя приложения или объекта, вызывавшего ошибку. (Унаследовано от Exception)
StackTrace	Получает строковое представление непосредственных кадров в стеке вызова. (Унаследовано от Exception)
TargetSite	Возвращает метод, создавший текущее исключение. (Унаследовано от Exception)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении. (Унаследовано от Exception)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

Является устаревшей.

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

Применяется к