MetadataReference.CreateFromFile 메서드

정의

네임스페이스:

Microsoft.CodeAnalysis

어셈블리:

Microsoft.CodeAnalysis.dll

패키지:

Microsoft.CodeAnalysis.Common v4.9.2

Source:

MetadataReference.cs

파일에 저장된 어셈블리 또는 독립 실행형 모듈에 대한 참조를 만듭니다. 파일의 내용을 메모리로 읽습니다.

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromFile (string path, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default);

static member CreateFromFile : string * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider -> Microsoft.CodeAnalysis.PortableExecutableReference

Public Shared Function CreateFromFile (path As String, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing) As PortableExecutableReference

매개 변수

path

String

어셈블리 파일의 경로입니다.

properties

MetadataReferenceProperties

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

documentation

DocumentationProvider

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

반환

PortableExecutableReference

예외

ArgumentNullException

path가 null입니다.

ArgumentException

path이 잘못되었습니다.

IOException

파일을 읽는 동안 오류가 발생했습니다.

설명

성능 고려 사항:

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

이 메서드는 파일의 전체 콘텐츠를 네이티브 힙으로 열심히 읽습니다. 네이티브 메모리 블록은 결과 참조에 연결할 수 없게 되고 GC가 이를 수집할 때 해제됩니다. 참조의 메모리 공간을 줄이거나 수명을 관리하려면 메타데이터 개체 GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) 를 만들고 IDisposable 참조를 가져오는 데 결정적으로 사용합니다CreateFromFile(String).