MetadataReference.CreateFromFile 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 ou un module autonome stocké dans un fichier. Lit le contenu du fichier en mémoire.
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 PortableExecutableReferenceParamètres
- path
- String
Chemin d’accès au fichier 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.
Retours
Exceptions
path a la valeur null.
path n'est pas valide.
Une erreur s’est produite lors de la lecture du fichier.
Remarques
Considérations relatives aux performances :
Il est recommandé d’utiliser CreateFromFile(String) ou CreateFromFile(String) d’API lors de la création de plusieurs références au même fichier. La réutilisation de l’objet permet de Metadata partager des données entre ces références.
La méthode lit avec impatience l’intégralité du contenu du fichier dans le 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 CreateFromFile(String) 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.
