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)

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);

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>。 当生成的引用变得无法访问并且 GC 收集它时，会释放固定内存。 控制固定内存确定性的生存期，用于 CreateFromStream(Stream, PEStreamOptions) 创建 IDisposable 元数据对象并 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 获取对它的引用。

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

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);

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 在托管堆中。 当生成的引用变得无法访问并且 GC 收集它时，会释放固定内存。 控制固定内存确定性的生存期，用于 CreateFromImage(ImmutableArray<Byte>) 创建 IDisposable 元数据对象并 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 获取对它的引用。

该方法创建对单模块程序集的引用。 若要创建对多模块程序集或独立模块的引用，请使用 CreateFromImage(ImmutableArray<Byte>) 和 GetReference(DocumentationProvider, String, String)。