ArrayTypeMismatchException Classe

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Exception levée quand une tentative est faite pour stocker un élément d'un type incorrect dans un tableau.

C#

public class ArrayTypeMismatchException : Exception

C#

public class ArrayTypeMismatchException : SystemException

C#

[System.Serializable]
public class ArrayTypeMismatchException : SystemException

C#

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

Héritage

Object

Exception

ArrayTypeMismatchException

Héritage

Object

Exception

SystemException

ArrayTypeMismatchException

Attributs

SerializableAttribute ComVisibleAttribute

Exemples

L’exemple de code suivant illustre les scénarios où ArrayTypeMismatchException est levée.

C#

using System;

namespace ArrayTypeMismatch
{
    class Class1
    {
        static void Main(string[] args)
        {
            string[] names = {"Dog", "Cat", "Fish"};
            Object[] objs  = (Object[]) names;

            try
            {
                objs[2] = "Mouse";

                foreach (object animalName in objs)
                {
                    System.Console.WriteLine(animalName);
                }
            }
            catch (System.ArrayTypeMismatchException)
            {
                // Not reached; "Mouse" is of the correct type.
                System.Console.WriteLine("Exception Thrown.");
            }

            try
            {
                Object obj = (Object) 13;
                objs[2] = obj;
            }
            catch (System.ArrayTypeMismatchException)
            {
                // Always reached, 13 is not a string.
                System.Console.WriteLine(
                    "New element is not of the correct type.");
            }

            // Set objs to an array of objects instead of
            // an array of strings.
            objs  = new Object[3];
            try
            {
                objs[0] = (Object) "Turtle";
                objs[1] = (Object) 12;
                objs[2] = (Object) 2.341;

                foreach (object element in objs)
                {
                    System.Console.WriteLine(element);
                }
            }
            catch (System.ArrayTypeMismatchException)
            {
                // ArrayTypeMismatchException is not thrown this time.
                System.Console.WriteLine("Exception Thrown.");
            }
        }
    }
}

Remarques

ArrayTypeMismatchException est levée lorsque le système ne peut pas convertir l’élément en type déclaré pour le tableau. Par exemple, un élément de type String ne peut pas être stocké dans un Int32 tableau, car la conversion entre ces types n’est pas prise en charge. Il est généralement inutile pour les applications de lever cette exception.

Les instructions MSIL (Microsoft Intermediate Language) suivantes lèvent ArrayTypeMismatchException:

• ldelem.<type>

• ldelema

• stelem.<type>

ArrayTypeMismatchException utilise le COR_E_ARRAYTYPEMISMATCH HRESULT, qui a la valeur 0x80131503.

Pour obtenir la liste des valeurs initiales des propriétés d’une instance de ArrayTypeMismatchException, consultez le ArrayTypeMismatchException constructeurs.

Constructeurs

ArrayTypeMismatchException()	Initialise une nouvelle instance de la classe ArrayTypeMismatchException.
ArrayTypeMismatchException(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe ArrayTypeMismatchException avec des données sérialisées.
ArrayTypeMismatchException(String)	Initialise une nouvelle instance de la classe ArrayTypeMismatchException avec un message d'erreur spécifié.
ArrayTypeMismatchException(String, Exception)	Initialise une nouvelle instance de la classe ArrayTypeMismatchException avec un message d'erreur spécifié et une référence à l'exception interne ayant provoqué cette exception.

Propriétés

Data	Obtient une collection de paires clé/valeur qui fournissent des informations définies par l'utilisateur supplémentaires sur l'exception. (Hérité de Exception)
HelpLink	Obtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception)
HResult	Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception)
InnerException	Obtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception)
Message	Obtient un message qui décrit l'exception active. (Hérité de Exception)
Source	Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception)
TargetSite	Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBaseException()	En cas de substitution dans une classe dérivée, retourne la Exception qui est à l'origine d'une ou de plusieurs exceptions ultérieures. (Hérité de Exception)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	En cas de substitution dans une classe dérivée, définit SerializationInfo avec des informations sur l'exception. (Hérité de Exception)
GetType()	Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception)

Événements

SerializeObjectState

Obsolète. Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception)

S’applique à

Voir aussi

• Exception
• Gestion et levée des exceptions