MetadataReference.CreateFromImage Methode

Definition

Namespace:

Microsoft.CodeAnalysis

Assembly:

Microsoft.CodeAnalysis.dll

Paket:

Microsoft.CodeAnalysis.Common v4.12.0

Überlädt

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Erstellt einen Verweis auf eine Einzelmodulassembly oder ein eigenständiges Modul, das im Arbeitsspeicher gespeichert ist.
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Erstellt einen Verweis auf eine Einzelmodulassembly oder ein eigenständiges Modul, das im Arbeitsspeicher gespeichert ist.

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)

Quelle:

MetadataReference.cs

Erstellt einen Verweis auf eine Einzelmodulassembly oder ein eigenständiges Modul, das im Arbeitsspeicher gespeichert ist.

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Generic.IEnumerable<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);

static member CreateFromImage : seq<byte> * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference

Public Shared Function CreateFromImage (peImage As IEnumerable(Of Byte), Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference

Parameter

peImage

IEnumerable<Byte>

Assemblyimage.

properties

MetadataReferenceProperties

Referenzeigenschaften (externe Aliase, Typeinbettung, MetadataImageKind).

documentation

DocumentationProvider

Stellt die XML-Dokumentation für Symbole bereit, die in der Referenz gefunden werden.

filePath

String

Optionaler Pfad, der den Speicherort der Metadaten beschreibt. Die Datei muss nicht auf dem Datenträger vorhanden sein. Der Pfad ist für den Compiler undurchsichtig.

Gibt zurück

PortableExecutableReference

Ausnahmen

ArgumentNullException

peImage ist NULL.

Hinweise

Leistungsaspekte:

Es wird empfohlen, beim Erstellen mehrerer Verweise auf dieselben Metadaten mehrere Verweise oder API zu verwenden CreateFromImage(IEnumerable<Byte>)CreateFromImage(IEnumerable<Byte>) . Das Erneute Verwenden eines Metadata Objekts zum Erstellen mehrerer Verweise ermöglicht die Freigabe von Daten über diese Verweise hinweg.

Die Methode erstellt eine Kopie der Daten und pinsiert sie an. Um zu vermeiden, eine Kopie zu erstellen, verwenden Sie eine Überladung, die eine ImmutableArray<T>. Der angeheftete Speicher wird freigegeben, wenn der resultierende Verweis nicht erreichbar ist und GC es sammelt. Um die Lebensdauer des angehefteten Speichers zu steuern, verwenden CreateFromStream(Stream, PEStreamOptions) Sie deterministisch zum Erstellen eines IDisposable Metadatenobjekts und GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) zum Abrufen eines Verweises darauf.

CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)

Quelle:

MetadataReference.cs

Erstellt einen Verweis auf eine Einzelmodulassembly oder ein eigenständiges Modul, das im Arbeitsspeicher gespeichert ist.

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Immutable.ImmutableArray<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);

static member CreateFromImage : System.Collections.Immutable.ImmutableArray<byte> * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference

Public Shared Function CreateFromImage (peImage As ImmutableArray(Of Byte), Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference

Parameter

peImage

ImmutableArray<Byte>

Assemblyimage.

properties

MetadataReferenceProperties

Referenzeigenschaften (externe Aliase, Typeinbettung, MetadataImageKind).

documentation

DocumentationProvider

Stellt die XML-Dokumentation für Symbole bereit, die in der Referenz gefunden werden.

filePath

String

Optionaler Pfad, der den Speicherort der Metadaten beschreibt. Die Datei muss nicht auf dem Datenträger vorhanden sein. Der Pfad ist für den Compiler undurchsichtig.

Gibt zurück

PortableExecutableReference

Ausnahmen

ArgumentNullException

peImage ist NULL.

Hinweise

Leistungsaspekte:

Es wird empfohlen, beim Erstellen mehrerer Verweise auf dieselben Metadaten mehrere Verweise oder API zu verwenden CreateFromImage(ImmutableArray<Byte>)CreateFromImage(ImmutableArray<Byte>) . Das Erneute Verwenden eines Metadata Objekts zum Erstellen mehrerer Verweise ermöglicht die Freigabe von Daten über diese Verweise hinweg.

Die Methodenheften in verwaltetem peImage Heap. Der angeheftete Speicher wird freigegeben, wenn der resultierende Verweis nicht erreichbar ist und GC es sammelt. Um die Lebensdauer des angehefteten Speichers zu steuern, verwenden CreateFromImage(ImmutableArray<Byte>) Sie deterministisch zum Erstellen eines IDisposable Metadatenobjekts und GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) zum Abrufen eines Verweises darauf.

Die Methode erstellt einen Verweis auf eine Einzelmodulassembly. Um einen Verweis auf eine Multimodulassembly oder ein eigenständiges Modul zu erstellen, verwenden CreateFromImage(ImmutableArray<Byte>) sie und GetReference(DocumentationProvider, String, String).