MetadataReference.CreateFromImage Méthode

Définition

Espace de noms:

Microsoft.CodeAnalysis

Assembly:

Microsoft.CodeAnalysis.dll

Paquet:

Microsoft.CodeAnalysis.Common v4.12.0

Surcharges

CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Crée une référence à un assembly à module unique ou à un module autonome stocké en mémoire.
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)	Crée une référence à un assembly à module unique ou à un module autonome stocké en mémoire.

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

Source:

MetadataReference.cs

Crée une référence à un assembly à module unique ou à un module autonome stocké en mémoire.

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

Paramètres

peImage

IEnumerable<Byte>

Image d’assembly.

properties

MetadataReferenceProperties

Propriétés de référence (alias extern, incorporation de type, MetadataImageKind).

documentation

DocumentationProvider

Fournit une documentation XML pour le symbole trouvé dans la référence.

filePath

String

Chemin d’accès facultatif qui décrit l’emplacement des métadonnées. Le fichier n’a pas besoin d’exister sur le disque. Le chemin d’accès est opaque pour le compilateur.

Retours

PortableExecutableReference

Exceptions

ArgumentNullException

peImage a la valeur null.

Remarques

Considérations relatives aux performances :

Il est recommandé d’utiliser CreateFromImage(IEnumerable<Byte>) ou CreateFromImage(IEnumerable<Byte>) d’API lors de la création de plusieurs références aux mêmes métadonnées. La réutilisation de l’objet Metadata pour créer plusieurs références permet de partager des données entre ces références.

La méthode effectue une copie des données et les épingle. Pour éviter d’utiliser une copie, utilisez une surcharge qui prend un ImmutableArray<T>. La mémoire épinglée est libérée lorsque la référence résultante devient inaccessible et que GC la collecte. Pour contrôler la durée de vie de la mémoire épinglée de manière déterministe, utilisez-la CreateFromStream(Stream, PEStreamOptions) pour créer un IDisposable objet de métadonnées et GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) obtenir une référence à celui-ci.

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

Source:

MetadataReference.cs

Crée une référence à un assembly à module unique ou à un module autonome stocké en mémoire.

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

Paramètres

peImage

ImmutableArray<Byte>

Image d’assembly.

properties

MetadataReferenceProperties

Propriétés de référence (alias extern, incorporation de type, MetadataImageKind).

documentation

DocumentationProvider

Fournit une documentation XML pour le symbole trouvé dans la référence.

filePath

String

Chemin d’accès facultatif qui décrit l’emplacement des métadonnées. Le fichier n’a pas besoin d’exister sur le disque. Le chemin d’accès est opaque pour le compilateur.

Retours

PortableExecutableReference

Exceptions

ArgumentNullException

peImage a la valeur null.

Remarques

Considérations relatives aux performances :

Il est recommandé d’utiliser CreateFromImage(ImmutableArray<Byte>) ou CreateFromImage(ImmutableArray<Byte>) d’API lors de la création de plusieurs références aux mêmes métadonnées. La réutilisation de l’objet Metadata pour créer plusieurs références permet de partager des données entre ces références.

Épingles peImage de méthode dans le tas managé. La mémoire épinglée est libérée lorsque la référence résultante devient inaccessible et que GC la collecte. Pour contrôler la durée de vie de la mémoire épinglée de manière déterministe, utilisez-la CreateFromImage(ImmutableArray<Byte>) pour créer un IDisposable objet de métadonnées et GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) obtenir une référence à celui-ci.

La méthode crée une référence à un assembly à module unique. Pour créer une référence à un assembly multimodèle ou à un module autonome et CreateFromImage(ImmutableArray<Byte>)GetReference(DocumentationProvider, String, String).