MetadataReference.CreateFromStream 方法

定義

命名空間:

Microsoft.CodeAnalysis

組件:

Microsoft.CodeAnalysis.dll

套件:

Microsoft.CodeAnalysis.Common v4.9.2

Source:

MetadataReference.cs

從指定資料流程中的資料建立單一模組元件或獨立模組的參考。 將資料流程的內容讀入記憶體，並在傳回時關閉資料流程。

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromStream (System.IO.Stream peStream, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);

static member CreateFromStream : System.IO.Stream * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference

Public Shared Function CreateFromStream (peStream As Stream, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference

參數

peStream

Stream

元件映射。

properties

MetadataReferenceProperties

參考屬性 (外部別名、輸入內嵌、 MetadataImageKind) 。

documentation

DocumentationProvider

提供參考中找到之符號的 XML 檔。

filePath

String

描述中繼資料位置的選擇性路徑。 檔案不需要存在於磁片上。 路徑對編譯器不透明。

傳回

PortableExecutableReference

例外狀況

ArgumentException

peStream 不支援讀取及搜尋作業。

ArgumentNullException

peStream 為 null。

IOException

讀取資料流程時發生錯誤。

備註

效能注意事項：

建立相同中繼資料的多個參考時，建議使用 CreateFromStream(Stream, PEStreamOptions) 或 CreateFromStream(Stream, PEStreamOptions) API。 Metadata重複使用 物件來建立多個參考，可讓您跨這些參考共用資料。

方法會積極將 的 peStream 整個內容讀入原生堆積。 當產生的參考變成無法連線，而且 GC 會收集它時，會釋放原生記憶體區塊。 若要減少參考和/或管理存留期的記憶體使用量，請確定性地使用 CreateFromStream(Stream, PEStreamOptions) 來建立 IDisposable 中繼資料物件，並 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 取得其參考。