Guide de référence de l'API de réflexion .NET Native
.NET Native comprend trois nouveaux types d’exceptions : System.Runtime.CompilerServices.MissingInteropDataException, System.Reflection.MissingMetadataException et System.Reflection.MissingRuntimeArtifactException. Notez les éléments suivants concernant ces trois types d'exception :
Ces types sont destinés à une utilisation interne uniquement.
Ces trois types d’exceptions sont uniquement destinés à l’utilisation de la chaîne d’outils .NET Native. Les exceptions sont levées lorsque la chaîne d’outils .NET Native détecte les données manquantes qui n’autorisent pas l’exécution du programme à continuer.
Ne gérez pas ces exceptions dans votre code.
Ces exceptions indiquent que des métadonnées requises par votre application sont absentes (exceptions MissingInteropDataException et MissingMetadataException ) ou que le code d'implémentation requis par votre application est manquant (exception MissingRuntimeArtifactException ). Vous pouvez corriger ces conditions d'exception en modifiant un fichier de directives runtime (.rd.xml) pour rendre disponibles les métadonnées ou le code d'implémentation nécessaires au moment de l'exécution. Pour plus d'informations, consultez Runtime Directives (rd.xml) Configuration File Reference. Deux utilitaires de résolution des problèmes sont disponibles. Ils fournissent les entrées appropriées pour votre fichier de directives runtime qui vont éliminer les exceptions MissingMetadataException et MissingRuntimeArtifactException :
l’ utilitaire de résolution des problèmes MissingMetadataException pour les types ;
l’ utilitaire de résolution des problèmes MissingMetadataException pour les méthodes.
Remarque
Cette référence documente trois types d’exceptions uniques à .NET Native. Pour obtenir de la documentation de référence sur l’API de réflexion .NET Framework Core, consultez les espaces de noms et System.Reflection.Emit les System.Reflectionespaces System.Reflection.Context de noms. Pour la documentation de référence sur l'API d'interopérabilité principale du .NET Framework, consultez System.Runtime.InteropServices.
Espace de noms System.Reflection
L’espace System.Reflection de noms contient les types principaux utilisés pour la réflexion dans .NET Framework. Pour .NET Native, il inclut également deux nouveaux types d’exceptions :
| Classe | Description |
|---|---|
| MissingMetadataException | Exception levée quand la réflexion est utilisée pour récupérer des métadonnées qui ne sont pas présentes. |
| MissingRuntimeArtifactException | Exception levée quand les métadonnées d'un type ou d'un membre de type sont disponibles, mais que leur implémentation a été supprimée. |
Pour obtenir de la documentation sur les autres types de cet espace de noms, consultez System.Reflection les pages de référence de l’API .NET.
Espace de noms System.Runtime.CompilerServices
L'espace de noms System.Runtime.CompilerServices comprend des types qui ont été conçus pour être utilisés par des compilateurs de langage. Pour .NET Native, il inclut également un nouveau type d’exception :
| Classe | Description |
|---|---|
| MissingInteropDataException | Exception levée quand une méthode de marshaling manuel est appelée, mais que les métadonnées d'un type sont introuvables par analyse statique ou dans un fichier de directives runtime. |
Pour obtenir de la documentation sur les autres types de cet espace de noms, consultez System.Runtime.CompilerServices les pages de référence de l’API .NET.