InvalidCastException Класс

Определение

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

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
Наследование
InvalidCastException
Наследование
InvalidCastException
Атрибуты

Комментарии

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

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

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

Примечание

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

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

Чтобы явное преобразование ссылки было успешным, исходное значение должно быть 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.
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 имеет значение on).

Однако если ни исходный тип, ни тип целевого объекта не определяют явное или понижающие преобразование между двумя типами, а 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.
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 интерфейс, DateTimeFormatInfo объект не связан с CultureInfo классом, от которого был получен объект интерфейса.

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

Так как сообщение об исключении указывает, преобразование будет выполнено, только если объект интерфейса преобразован обратно в экземпляр исходного типа, в данном случае a 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;
   }
}

Примечание

использование оператора 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

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)

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

См. также раздел