Поделиться через


MetadataReference.CreateFromImage Метод

Определение

Перегрузки

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

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

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

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

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

Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
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);
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

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

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

Исключения

Параметр 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)

Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
MetadataReference.cs
Source:
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);
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

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

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

Исключения

Параметр 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)

Применяется к