.NET Native-Reflektions-API-Referenz
.NET Native enthält drei neue Ausnahmetypen: System.Runtime.CompilerServices.MissingInteropDataException, System.Reflection.MissingMetadataException und System.Reflection.MissingRuntimeArtifactException. Beachten Sie für alle drei Ausnahmetypen die folgenden Punkte:
Diese Typen sind nur zur internen Verwendung vorgesehen.
Diese drei Ausnahmetypen dienen nur der Verwendung der .NET Native-Toolkette. Die Ausnahmen werden ausgelöst, wenn die .NET Native-Toolkette fehlende Daten erkennt, die nicht zulassen, dass die Programmausführung fortgesetzt werden kann.
Diese Ausnahmen dürfen im eigenen Code nicht behandelt werden.
Diese Ausnahmen geben entweder an, dass von der Anwendung benötigte Metadaten fehlen (Ausnahmen MissingInteropDataException und MissingMetadataException ), oder dass von der Anwendung benötigter Implementierungscode fehlt (Ausnahme MissingRuntimeArtifactException ). Sie beheben diese Ausnahmebedingungen, indem Sie eine Laufzeitdirektivendatei (.rd.xml) so ändern, dass die benötigten Metadaten bzw. Implementierungscodes zur Laufzeit verfügbar sind. Weitere Informationen finden Sie unter Runtime Directives (rd.xml) Configuration File Reference. Es sind zwei Problembehandlungen verfügbar, die die entsprechenden Einträge für die Laufzeitdirektivendatei bereitstellen, mit der die MissingMetadataException - und MissingRuntimeArtifactException -Ausnahmen beseitigt werden:
Die MissingMetadataException-Problembehandlung für Typen.
Die MissingMetadataException-Problembehandlung für Methoden.
Hinweis
Diese Referenz dokumentiert drei Ausnahmetypen, die für .NET Native eindeutig sind. Referenzdokumentation für die .NET Framework Core Reflection API finden Sie in den System.ReflectionSystem.Reflection.Context Namespaces und System.Reflection.Emit den .NET Framework-Kernreflektions-API. Eine Referenzdokumentation für die zentrale .NET Framework-Interop-API finden Sie unter System.Runtime.InteropServices.
System.Reflection-Namespace
Der System.Reflection Namespace enthält die Kerntypen, die für die Reflexion in .NET Framework verwendet werden. Für .NET Native enthält sie auch zwei neue Ausnahmetypen:
| Klasse | Beschreibung |
|---|---|
| MissingMetadataException | Die Ausnahme, die ausgelöst wird, wenn Reflektion verwendet wird, um Metadaten abzurufen, die nicht vorhanden sind. |
| MissingRuntimeArtifactException | Die Ausnahme, die ausgelöst wird, wenn Metadaten für einen Typ oder Typmember verfügbar sind, aber dessen Implementierung entfernt wurde. |
Dokumentation zu den anderen Typen in diesem Namespace finden Sie System.Reflection auf den Referenzseiten der .NET-API.
System.Runtime.CompilerServices-Namespace
Der System.Runtime.CompilerServices -Namespace enthält für Benutzer entworfene Typen nach Sprachcompilern. Für .NET Native enthält sie auch einen neuen Ausnahmetyp:
| Klasse | Beschreibung |
|---|---|
| MissingInteropDataException | Die Ausnahme, die ausgelöst wird, wenn eine manuelle Marshallingmethode aufgerufen wird, aber keine Metadaten für einen Typ durch statische Analyse oder in einer Laufzeitrichtliniendatei gefunden werden. |
Dokumentation zu den anderen Typen in diesem Namespace finden Sie System.Runtime.CompilerServices auf den Referenzseiten der .NET-API.