MetadataReference.CreateFromImage Metode

Definisi

Ruang nama:

Microsoft.CodeAnalysis

Rakitan:

Microsoft.CodeAnalysis.dll

Paket:

Microsoft.CodeAnalysis.Common v4.9.2

Overload

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Membuat referensi ke rakitan modul tunggal atau modul mandiri yang disimpan dalam memori.
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Membuat referensi ke rakitan modul tunggal atau modul mandiri yang disimpan dalam memori.

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

Source:

MetadataReference.cs

Membuat referensi ke rakitan modul tunggal atau modul mandiri yang disimpan dalam memori.

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>

Gambar assembly.

properties

MetadataReferenceProperties

Properti referensi (alias ekstern, ketik embedding, MetadataImageKind).

documentation

DocumentationProvider

Menyediakan dokumentasi XML untuk simbol yang ditemukan dalam referensi.

filePath

String

Jalur opsional yang menjelaskan lokasi metadata. File tidak perlu ada pada disk. Jalur buram ke pengkompilasi.

Mengembalikan

PortableExecutableReference

Pengecualian

ArgumentNullException

peImage adalah null.

Keterangan

Pertimbangan performa:

Disarankan untuk menggunakan CreateFromImage(IEnumerable<Byte>) atau CreateFromImage(IEnumerable<Byte>) API saat membuat beberapa referensi ke metadata yang sama. Menggunakan kembali Metadata objek untuk membuat beberapa referensi memungkinkan berbagi data di seluruh referensi ini.

Metode ini membuat salinan data dan menyematkannya. Untuk menghindari pembuatan salinan, gunakan kelebihan beban yang mengambil ImmutableArray<T>. Memori yang disematkan dirilis ketika referensi yang dihasilkan menjadi tidak dapat dijangkau dan GC mengumpulkannya. Untuk mengontrol masa pakai memori yang disematkan, gunakan CreateFromStream(Stream, PEStreamOptions) secara deterministik untuk membuat IDisposable objek metadata dan GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) untuk mendapatkan referensi ke dalamnya.

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

Source:

MetadataReference.cs

Membuat referensi ke rakitan modul tunggal atau modul mandiri yang disimpan dalam memori.

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>

Gambar assembly.

properties

MetadataReferenceProperties

Properti referensi (alias ekstern, ketik embedding, MetadataImageKind).

documentation

DocumentationProvider

Menyediakan dokumentasi XML untuk simbol yang ditemukan dalam referensi.

filePath

String

Jalur opsional yang menjelaskan lokasi metadata. File tidak perlu ada pada disk. Jalur buram ke pengkompilasi.

Mengembalikan

PortableExecutableReference

Pengecualian

ArgumentNullException

peImage adalah null.

Keterangan

Pertimbangan performa:

Disarankan untuk menggunakan CreateFromImage(ImmutableArray<Byte>) atau CreateFromImage(ImmutableArray<Byte>) API saat membuat beberapa referensi ke metadata yang sama. Menggunakan kembali Metadata objek untuk membuat beberapa referensi memungkinkan berbagi data di seluruh referensi ini.

Metode menyematkan peImage tumpukan terkelola. Memori yang disematkan dirilis ketika referensi yang dihasilkan menjadi tidak dapat dijangkau dan GC mengumpulkannya. Untuk mengontrol masa pakai memori yang disematkan, gunakan CreateFromImage(ImmutableArray<Byte>) secara deterministik untuk membuat IDisposable objek metadata dan GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) untuk mendapatkan referensi ke dalamnya.

Metode ini membuat referensi ke rakitan modul tunggal. Untuk membuat referensi ke rakitan multi-modul atau penggunaan CreateFromImage(ImmutableArray<Byte>) modul yang berdiri sendiri dan GetReference(DocumentationProvider, String, String).