MetadataReference.CreateFromImage Метод

Определение

Пространство имен:

Microsoft.CodeAnalysis

Сборка:

Microsoft.CodeAnalysis.dll

Пакет:

Microsoft.CodeAnalysis.Common v4.12.0

Перегрузки

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Создает ссылку на сборку с одним модулем или автономный модуль, хранящийся в памяти.
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Создает ссылку на сборку с одним модулем или автономный модуль, хранящийся в памяти.

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

Исходный код:

MetadataReference.cs

Создает ссылку на сборку с одним модулем или автономный модуль, хранящийся в памяти.

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

Параметры

peImage

IEnumerable<Byte>

Образ сборки.

properties

MetadataReferenceProperties

Ссылочные свойства (экстерн-псевдонимы, внедрение типов, MetadataImageKind).

documentation

DocumentationProvider

Предоставляет XML-документацию по символам, найденным в ссылке.

filePath

String

Необязательный путь, описывающий расположение метаданных. Файл не должен существовать на диске. Путь непрозрачн к компилятору.

Возвращаемое значение

PortableExecutableReference

Исключения

ArgumentNullException

Параметр peImage имеет значение null.

Комментарии

Вопросы производительности:

Рекомендуется использовать CreateFromImage(IEnumerable<Byte>) или CreateFromImage(IEnumerable<Byte>) API при создании нескольких ссылок на одни и те же метаданные. Повторное использование Metadata объекта для создания нескольких ссылок позволяет совместно использовать данные между этими ссылками.

Метод создает копию данных и закрепляет их. Чтобы избежать копирования, используйте перегрузку, которая принимает .ImmutableArray<T> Закрепленная память освобождается, когда результирующая ссылка становится недоступной, и сборщик мусора собирает ее. Для управления временем существования закрепленной памяти детерминированное использование CreateFromStream(Stream, PEStreamOptions) для создания IDisposable объекта метаданных и GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) получения ссылки на него.

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

Исходный код:

MetadataReference.cs

Создает ссылку на сборку с одним модулем или автономный модуль, хранящийся в памяти.

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

Параметры

peImage

ImmutableArray<Byte>

Образ сборки.

properties

MetadataReferenceProperties

Ссылочные свойства (экстерн-псевдонимы, внедрение типов, MetadataImageKind).

documentation

DocumentationProvider

Предоставляет XML-документацию по символам, найденным в ссылке.

filePath

String

Необязательный путь, описывающий расположение метаданных. Файл не должен существовать на диске. Путь непрозрачн к компилятору.

Возвращаемое значение

PortableExecutableReference

Исключения

ArgumentNullException

Параметр peImage имеет значение null.

Комментарии

Вопросы производительности:

Рекомендуется использовать CreateFromImage(ImmutableArray<Byte>) или CreateFromImage(ImmutableArray<Byte>) API при создании нескольких ссылок на одни и те же метаданные. Повторное использование Metadata объекта для создания нескольких ссылок позволяет совместно использовать данные между этими ссылками.

Метод закрепляется peImage в управляемой куче. Закрепленная память освобождается, когда результирующая ссылка становится недоступной, и сборщик мусора собирает ее. Для управления временем существования закрепленной памяти детерминированное использование CreateFromImage(ImmutableArray<Byte>) для создания IDisposable объекта метаданных и GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) получения ссылки на него.

Этот метод создает ссылку на сборку с одним модулем. Создание ссылки на сборку с несколькими модулями или использование CreateFromImage(ImmutableArray<Byte>) автономного модуля.GetReference(DocumentationProvider, String, String)