MetadataReference.CreateFromFile Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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);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.PortableExecutableReferencePublic Shared Function CreateFromFile (path As String, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing) As PortableExecutableReferencePará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
Excepciones
path es null.
path no es válido.
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.
