MetadataReference.CreateFromStream Méthode

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée une référence à un assembly à module unique ou à un module autonome à partir de données dans le flux spécifié. Lit le contenu du flux en mémoire et ferme le flux lors du retour.

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromStream (System.IO.Stream peStream, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider documentation = default, string filePath = default);

public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromStream (System.IO.Stream peStream, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);

static member CreateFromStream : System.IO.Stream * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference

Public Shared Function CreateFromStream (peStream As Stream, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference

Paramètres

peStream: Stream

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

ArgumentException

peStream ne prend pas en charge les opérations de lecture et de recherche.

ArgumentNullException

peStream a la valeur null.

IOException

Une erreur s’est produite lors de la lecture du flux.

Remarques

Considérations relatives aux performances :

Il est recommandé d’utiliser CreateFromStream(Stream, PEStreamOptions) ou CreateFromStream(Stream, PEStreamOptions) 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 lit avec impatience l’intégralité du contenu du peStream tas natif. Le bloc de mémoire natif est libéré lorsque la référence résultante devient inaccessible et que GC la collecte. Pour réduire l’empreinte mémoire de la référence et/ou gérer la durée de vie de manière CreateFromStream(Stream, PEStreamOptions) déterministe 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.

S’applique à

Partager via