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)

ソース:

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

参照プロパティ (extern エイリアス、型埋め込み、 MetadataImageKind)。

documentation

DocumentationProvider

リファレンスにあるシンボルの XML ドキュメントを提供します。

filePath

String

メタデータの場所を表す省略可能なパス。 ファイルはディスク上に存在する必要はありません。 パスはコンパイラに対して不透明です。

戻り値

PortableExecutableReference

例外

ArgumentNullException

peImage が null です。

注釈

パフォーマンスに関する考慮事項:

同じメタデータへの複数の参照を作成する場合は、API をCreateFromImage(IEnumerable<Byte>)使用CreateFromImage(IEnumerable<Byte>)することをお勧めします。 オブジェクトを再利用して Metadata 複数の参照を作成すると、これらの参照間でデータを共有できます。

このメソッドは、データのコピーを作成し、ピン留めします。 コピー ImmutableArray<T>を作成しないようにするには、. ピン留めされたメモリは、結果の参照に到達不能になり、GC によって収集されると解放されます。 ピン留めされたメモリの有効期間を制御するには、メタデータ オブジェクトを作成IDisposableし、GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String)それに対する参照を取得するために決定的に使用CreateFromStream(Stream, PEStreamOptions)します。

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

ソース:

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

参照プロパティ (extern エイリアス、型埋め込み、 MetadataImageKind)。

documentation

DocumentationProvider

リファレンスにあるシンボルの XML ドキュメントを提供します。

filePath

String

メタデータの場所を表す省略可能なパス。 ファイルはディスク上に存在する必要はありません。 パスはコンパイラに対して不透明です。

戻り値

PortableExecutableReference

例外

ArgumentNullException

peImage が null です。

注釈

パフォーマンスに関する考慮事項:

同じメタデータへの複数の参照を作成する場合は、API をCreateFromImage(ImmutableArray<Byte>)使用CreateFromImage(ImmutableArray<Byte>)することをお勧めします。 オブジェクトを再利用して Metadata 複数の参照を作成すると、これらの参照間でデータを共有できます。

メソッドはマネージド ヒープにピン留 peImage めされます。 ピン留めされたメモリは、結果の参照に到達不能になり、GC によって収集されると解放されます。 ピン留めされたメモリの有効期間を制御するには、メタデータ オブジェクトを作成IDisposableし、GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String)それに対する参照を取得するために決定的に使用CreateFromImage(ImmutableArray<Byte>)します。

このメソッドは、単一モジュール アセンブリへの参照を作成します。 マルチモジュール アセンブリまたはスタンドアロン モジュールへの参照を作成するには、次の値を使用 CreateFromImage(ImmutableArray<Byte>) します GetReference(DocumentationProvider, String, String)。