MetadataReference.CreateFromFile 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 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.PortableExecutableReference

Public Shared Function CreateFromFile (path As String, Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing) As PortableExecutableReference

Paramè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

PortableExecutableReference

Exceptions

ArgumentNullException

path a la valeur null.

ArgumentException

path n'est pas valide.

IOException

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.

S’applique à

Partager via