MetadataReference.CreateFromImage 方法

定義

命名空間:

Microsoft.CodeAnalysis

組件:

Microsoft.CodeAnalysis.dll

套件:

Microsoft.CodeAnalysis.Common v4.9.2

多載

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 選在 Managed 堆積中。 當產生的參考變成無法連線，而且 GC 會收集它時釋放固定的記憶體。 若要控制固定記憶體的存留期，可確定性地用來 CreateFromImage(ImmutableArray<Byte>) 建立 IDisposable 中繼資料物件，並 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 取得其參考。

方法會建立單一模組元件的參考。 若要建立多模組元件或獨立模組的參考，請使用 CreateFromImage(ImmutableArray<Byte>) 和 GetReference(DocumentationProvider, String, String) 。