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.PortableExecutableReferencePublic 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.PortableExecutableReferencePublic 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)
