MetadataReference.CreateFromImage Método

Definición

Espacio de nombres:

Microsoft.CodeAnalysis

Ensamblado:

Microsoft.CodeAnalysis.dll

Paquete:

Microsoft.CodeAnalysis.Common v4.9.2

Sobrecargas

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Crea una referencia a un ensamblado de un solo módulo o a un módulo independiente almacenado en memoria.
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Crea una referencia a un ensamblado de un solo módulo o a un módulo independiente almacenado en memoria.

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

Source:

MetadataReference.cs

Crea una referencia a un ensamblado de un solo módulo o a un módulo independiente almacenado en memoria.

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

Parámetros

peImage

IEnumerable<Byte>

Imagen 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.

filePath

String

Ruta de acceso opcional que describe la ubicación de los metadatos. El archivo no necesita existir en el disco. La ruta de acceso es opaca para el compilador.

Devoluciones

PortableExecutableReference

Excepciones

ArgumentNullException

peImage es null.

Comentarios

Consideraciones de rendimiento:

Se recomienda usar CreateFromImage(IEnumerable<Byte>) o CreateFromImage(IEnumerable<Byte>) la API al crear varias referencias a los mismos metadatos. Reutilizar el Metadata objeto para crear varias referencias permite compartir datos entre estas referencias.

El método realiza una copia de los datos y lo ancla. Para evitar hacer que una copia use una sobrecarga que toma un ImmutableArray<T>. La memoria anclada se libera cuando la referencia resultante deja de ser accesible y gc la recopila. Para controlar la duración de la memoria anclada de forma determinista, use CreateFromStream(Stream, PEStreamOptions) para crear un IDisposable objeto de metadatos y GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) obtener una referencia a él.

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

Source:

MetadataReference.cs

Crea una referencia a un ensamblado de un solo módulo o a un módulo independiente almacenado en memoria.

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

Parámetros

peImage

ImmutableArray<Byte>

Imagen 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.

filePath

String

Ruta de acceso opcional que describe la ubicación de los metadatos. El archivo no necesita existir en el disco. La ruta de acceso es opaca para el compilador.

Devoluciones

PortableExecutableReference

Excepciones

ArgumentNullException

peImage es null.

Comentarios

Consideraciones de rendimiento:

Se recomienda usar CreateFromImage(ImmutableArray<Byte>) o CreateFromImage(ImmutableArray<Byte>) la API al crear varias referencias a los mismos metadatos. Reutilizar el Metadata objeto para crear varias referencias permite compartir datos entre estas referencias.

El método ancla peImage en el montón administrado. La memoria anclada se libera cuando la referencia resultante deja de ser accesible y gc la recopila. Para controlar la duración de la memoria anclada de forma determinista, use CreateFromImage(ImmutableArray<Byte>) para crear un IDisposable objeto de metadatos y GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) obtener una referencia a él.

El método crea una referencia a un ensamblado de un solo módulo. Para crear una referencia a un ensamblado de varios módulos o a un módulo independiente, use CreateFromImage(ImmutableArray<Byte>) y GetReference(DocumentationProvider, String, String).