MetadataReference.CreateFromStream Méthode
Définition
Important
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.PortableExecutableReferencePublic Shared Function CreateFromStream (peStream As Stream, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReferenceParamè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
Exceptions
peStream ne prend pas en charge les opérations de lecture et de recherche.
peStream a la valeur null.
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.
