Classe System.InvalidCastException

Questo articolo fornisce osservazioni supplementari alla documentazione di riferimento per questa API.

.NET supporta la conversione automatica dai tipi derivati ai relativi tipi di base e viceversa, nonché dai tipi che presentano interfacce a oggetti interfaccia e viceversa. Include anche un'ampia gamma di meccanismi che supportano conversioni personalizzate. Per altre informazioni, vedere Conversione dei tipi in .NET.

Viene generata un'eccezione InvalidCastException quando la conversione di un'istanza di un tipo in un altro tipo non è supportata. Ad esempio, il tentativo di convertire un Char valore in un DateTime valore genera un'eccezione InvalidCastException . Differisce da un'eccezione OverflowException , generata quando è supportata una conversione di un tipo a un altro, ma il valore del tipo di origine non è compreso nell'intervallo del tipo di destinazione. Un'eccezione InvalidCastException è causata da un errore dello sviluppatore e non deve essere gestita in un try/catch blocco. Al contrario, la causa dell'eccezione deve essere eliminata.

Per informazioni sulle conversioni supportate dal sistema, vedere la Convert classe . Per gli errori che si verificano quando il tipo di destinazione può archiviare i valori del tipo di origine ma non è sufficientemente grande da archiviare un valore di origine specifico, vedere l'eccezione OverflowException .

Nota

In molti casi, il compilatore del linguaggio rileva che non esiste alcuna conversione tra il tipo di origine e il tipo di destinazione e genera un errore del compilatore.

Alcune delle condizioni in cui una conversione tentata genera un'eccezione InvalidCastException sono descritte nelle sezioni seguenti.

Affinché una conversione di riferimento esplicita venga eseguita correttamente, il valore di origine deve essere nullo il tipo di oggetto a cui fa riferimento l'argomento di origine deve essere convertibile nel tipo di destinazione tramite una conversione di riferimento implicita.

Le istruzioni del linguaggio intermedio (IL) seguenti generano un'eccezione InvalidCastException :

• castclass
• refanyval
• unbox

InvalidCastException usa HRESULT COR_E_INVALIDCAST, che ha il valore 0x80004002.

Per un elenco dei valori iniziali delle proprietà per un'istanza di InvalidCastException, consultare i costruttori di InvalidCastException.

Tipi primitivi e IConvertible

Si chiama direttamente o indirettamente l'implementazione di un tipo primitivo IConvertible che non supporta una particolare conversione. Ad esempio, il tentativo di convertire un valore Boolean in un valore Char o un valore DateTime in un valore Int32 genera un'eccezione InvalidCastException. Nell'esempio seguente vengono chiamati entrambi i metodi Boolean.IConvertible.ToChar e Convert.ToChar(Boolean) per convertire un valore Boolean in un Char. In entrambi i casi, la chiamata al metodo genera un'eccezione InvalidCastException .

C#

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.

Poiché la conversione non è supportata, non esiste alcuna soluzione alternativa.

Il metodo Convert.ChangeType

Hai chiamato il metodo Convert.ChangeType per convertire un oggetto da un tipo a un altro, ma uno o entrambi i tipi non implementano l'interfaccia IConvertible.

Nella maggior parte dei casi, poiché la conversione non è supportata, non esiste alcuna soluzione alternativa. In alcuni casi, una possibile soluzione alternativa consiste nell'assegnare manualmente i valori delle proprietà dal tipo di origine a proprietà simili di un tipo di destinazione.

Conversioni di tipo narrowing e implementazioni IConvertible

Gli operatori di narrowing definiscono le conversioni esplicite supportate da un tipo. Per eseguire la conversione, è necessario un operatore di cast in C# o il CType metodo di conversione in Visual Basic (se Option Strict è attivo).

Tuttavia, se né il tipo di origine né il tipo di destinazione definiscono una conversione esplicita o ridotta tra i due tipi e l'implementazione IConvertible di uno o entrambi i tipi non supporta una conversione dal tipo di origine al tipo di destinazione, viene generata un'eccezione InvalidCastException .

Nella maggior parte dei casi, poiché la conversione non è supportata, non esiste alcuna soluzione alternativa.

Conversione verso il basso

Si sta effettuando un downcast, ovvero si sta provando a convertire un'istanza di un tipo di base in uno dei relativi tipi derivati. Nell'esempio seguente il tentativo di convertire un Person oggetto in un PersonWithID oggetto ha esito negativo.

C#

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.

Come illustrato nell'esempio, il downcast ha esito positivo solo se l'oggetto Person è stato creato da un upcast da un PersonWithId oggetto a un Person oggetto o se l'oggetto Person è null.

Conversione da un oggetto interfaccia

Si sta tentando di convertire un oggetto interfaccia in un tipo che implementa tale interfaccia, ma il tipo di destinazione non è lo stesso tipo o una classe di base del tipo da cui è stato originariamente derivato l'oggetto interfaccia. Nell'esempio seguente viene generata un'eccezione InvalidCastException quando tenta di convertire un IFormatProvider oggetto in un DateTimeFormatInfo oggetto . La conversione non riesce perché anche se la DateTimeFormatInfo classe implementa l'interfaccia IFormatProvider , l'oggetto DateTimeFormatInfo non è correlato alla CultureInfo classe da cui è stato derivato l'oggetto interfaccia.

C#

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

Come indica il messaggio di eccezione, la conversione avrà esito positivo solo se l'oggetto interfaccia viene convertito nuovamente in un'istanza del tipo originale, in questo caso un oggetto CultureInfo. La conversione avrà esito positivo anche se l'oggetto interfaccia viene convertito in un'istanza di un tipo di base del tipo originale.

Conversioni di stringhe

Si sta tentando di convertire un valore o un oggetto nella relativa rappresentazione di stringa usando un operatore di cast in C#. Nell'esempio seguente, sia il tentativo di eseguire il cast di un Char valore a una stringa che il tentativo di eseguire il cast di un numero intero in una stringa genera un'eccezione InvalidCastException .

C#

public class StringEx
{
    public static void Main()
    {
        object value = 12;
        // Cast throws an InvalidCastException exception.
        string s = (string)value;
    }
}

Nota

Utilizzo dell'operatore Visual Basic CStr per convertire un valore di un tipo primitivo in una stringa ha esito positivo. L'operazione non genera un'eccezione InvalidCastException .

Per convertire correttamente un'istanza di qualsiasi tipo nella relativa rappresentazione di stringa, chiamare il relativo ToString metodo, come nell'esempio seguente. Il ToString metodo è sempre presente, poiché il ToString metodo è definito dalla Object classe e pertanto viene ereditato o sottoposto a override da tutti i tipi gestiti.

C#

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

Migrazione di Visual Basic 6.0

Si sta aggiornando un'applicazione Visual Basic 6.0 con una chiamata a un evento personalizzato in un controllo utente a Visual Basic .NET e viene generata un'eccezione InvalidCastException con il messaggio "Cast specificato non valido". Per eliminare questa eccezione, modificare la riga di codice nel modulo ( ad esempio Form1)

VB

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

e sostituirlo con la riga di codice seguente:

VB

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