Freigeben über


PortableExecutableReference.GetMetadataImpl Methode

Definition

Abrufen der Metadatendarstellung für die PE-Datei.

protected:
 abstract Microsoft::CodeAnalysis::Metadata ^ GetMetadataImpl();
protected abstract Microsoft.CodeAnalysis.Metadata GetMetadataImpl ();
abstract member GetMetadataImpl : unit -> Microsoft.CodeAnalysis.Metadata
Protected MustOverride Function GetMetadataImpl () As Metadata

Gibt zurück

Ausnahmen

Wenn das PE-Bildformat ungültig ist.

Der Metadatenbildinhalt kann nicht gelesen werden.

Das Metadatenbild wird in einer Datei gespeichert, die nicht gefunden werden kann.

Hinweise

Wird aufgerufen, wenn die Compilation Referenzmetadaten gelesen werden müssen.

Die aufgeführten Ausnahmen werden abgefangen und in kompilierte Diagnose konvertiert. Jede andere Ausnahme gilt als unerwarteter Fehler in der Implementierung und wird nicht erfasst.

Metadata Objekte können Informationen zwischenspeichern, die aus dem PE-Bild decodiert werden. Das Erneute Verwenden von Metadata Instanzen über Metadatenverweise führt zu einer besseren Leistung.

Der Aufruf Compilation übernimmt nicht den Besitz der Metadata von dieser Methode zurückgegebenen Objekte. Die Implementierung muss das Objekt von einem Anbieter abrufen, der seine Lebensdauer verwaltet (z. B. Metadatencache). Das Metadata Objekt wird von dem Compilation aufgerufenen Microsoft.CodeAnalysis.PortableExecutableReference.GetMetadataNoCopy und von allen Kompilierungen, die über Aufrufe von With-Factory-Methoden Compilationerstellt wurden, WithReferences(MetadataReference[]) auf anderen als Überladungen lebendig gehalten. Eine kompilierung, die mithilfe WithReferences(MetadataReference[]) der Verwendung erstellt wird, ruft erneut auf Microsoft.CodeAnalysis.PortableExecutableReference.GetMetadataNoCopy .

Gilt für: