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

참조 속성(extern 별칭, 형식 포함, MetadataImageKind).

documentation

DocumentationProvider

참조에 있는 기호에 대한 XML 설명서를 제공합니다.

filePath

String

메타데이터의 위치를 설명하는 선택적 경로입니다. 파일이 디스크에 있을 필요가 없습니다. 경로가 컴파일러에 불투명합니다.

반환

PortableExecutableReference

예외

ArgumentNullException

peImage가 null입니다.

설명

성능 고려 사항:

동일한 메타데이터에 대한 여러 참조를 만들 때 사용 CreateFromImage(IEnumerable<Byte>) 하거나 CreateFromImage(IEnumerable<Byte>) API를 사용하는 것이 좋습니다. 개체를 Metadata 다시 사용하여 여러 참조를 만들면 이러한 참조 간에 데이터를 공유할 수 있습니다.

메서드는 데이터의 복사본을 만들어 고정합니다. 복사본을 만들지 않도록 하려면 .을 사용하는 오버로드를 ImmutableArray<T>사용합니다. 고정된 메모리는 결과 참조에 연결할 수 없게 되고 GC에서 수집할 때 해제됩니다. 고정된 메모리의 수명을 제어하려면 메타데이터 개체를 만들고 IDisposable 해당 개체 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 에 대한 참조를 가져오는 데 결정적으로 사용합니다CreateFromStream(Stream, PEStreamOptions).

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

참조 속성(extern 별칭, 형식 포함, MetadataImageKind).

documentation

DocumentationProvider

참조에 있는 기호에 대한 XML 설명서를 제공합니다.

filePath

String

메타데이터의 위치를 설명하는 선택적 경로입니다. 파일이 디스크에 있을 필요가 없습니다. 경로가 컴파일러에 불투명합니다.

반환

PortableExecutableReference

예외

ArgumentNullException

peImage가 null입니다.

설명

성능 고려 사항:

동일한 메타데이터에 대한 여러 참조를 만들 때 사용 CreateFromImage(ImmutableArray<Byte>) 하거나 CreateFromImage(ImmutableArray<Byte>) API를 사용하는 것이 좋습니다. 개체를 Metadata 다시 사용하여 여러 참조를 만들면 이러한 참조 간에 데이터를 공유할 수 있습니다.

메서드는 관리되는 힙에 고정됩니다 peImage . 고정된 메모리는 결과 참조에 연결할 수 없게 되고 GC에서 수집할 때 해제됩니다. 고정된 메모리의 수명을 제어하려면 메타데이터 개체를 만들고 IDisposable 해당 개체 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 에 대한 참조를 가져오는 데 결정적으로 사용합니다CreateFromImage(ImmutableArray<Byte>).

이 메서드는 단일 모듈 어셈블리에 대한 참조를 만듭니다. 다중 모듈 어셈블리 또는 독립 실행형 모듈에 대한 참조를 만들려면 다음GetReference(DocumentationProvider, String, String)을 사용합니다CreateFromImage(ImmutableArray<Byte>).