MetadataReference.CreateFromFile Método

Definición

Espacio de nombres:

Microsoft.CodeAnalysis

Ensamblado:

Microsoft.CodeAnalysis.dll

Paquete:

Microsoft.CodeAnalysis.Common v4.9.2

Source:

MetadataReference.cs

Crea una referencia a un ensamblado o módulo independiente almacenado en un archivo. Lee el contenido del archivo en la memoria.

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

Parámetros

path

String

Ruta de acceso al archivo de ensamblado.

properties

MetadataReferenceProperties

Propiedades de referencia (alias de extern, inserción de tipos, MetadataImageKind).

documentation

DocumentationProvider

Proporciona documentación XML para el símbolo que se encuentra en la referencia.

Devoluciones

PortableExecutableReference

Excepciones

ArgumentNullException

path es null.

ArgumentException

path no es válido.

IOException

Error al leer el archivo.

Comentarios

Consideraciones de rendimiento:

Se recomienda usar CreateFromFile(String) o CreateFromFile(String) la API al crear varias referencias al mismo archivo. La reutilización del Metadata objeto permite compartir datos entre estas referencias.

El método lee diligentemente todo el contenido del archivo en el montón nativo. El bloque de memoria nativa se libera cuando la referencia resultante deja de ser accesible y gc la recopila. Para reducir la superficie de memoria de la referencia o administrar la duración de forma determinista, use CreateFromFile(String) para crear un IDisposable objeto de metadatos y GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) obtener una referencia a él.