Assembly, classe

Utilisez la classe Assembly pour charger des assemblys, explorer les métadonnées et les parties constituantes des assemblys, découvrir les types contenus dans des assemblys et créer des instances de ces types.

Pour obtenir un tableau d'objets Assembly représentant les assemblys actuellement chargés dans un domaine d'application (par exemple, le domaine d'application par défaut d'un projet simple), utilisez la méthode AppDomain.GetAssemblies.

Pour charger des assemblys de façon dynamique, la classe Assembly fournit les méthodes statiques suivantes (méthodes Shared en Visual Basic). Les assemblys sont chargés dans le domaine d'application où l'opération de chargement se produit.

• La procédure recommandée pour charger des assemblys consiste à utiliser la méthode Load, qui identifie l'assembly à charger par son nom complet (par exemple, "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). La recherche de l'assembly suit les règles décrites dans Méthode de localisation des assemblys par le runtime.

• Les méthodes ReflectionOnlyLoad et ReflectionOnlyLoadFrom vous permettent de charger un assembly pour la réflexion, mais pas pour l'exécution. Par exemple, un assembly qui cible une plateforme 64 bits peut être examiné par du code qui s'exécute sur une plateforme 32 bits.

• Les méthodes LoadFile et LoadFrom sont fournies pour les rares scénarios dans lesquels un assembly doit être identifié par un chemin d'accès.

Pour obtenir un objet Assembly pour l'assembly en cours d'exécution, utilisez la méthode GetExecutingAssembly.

De nombreux membres de la classe Assembly fournissent des informations sur un assembly. Par exemple :

• La méthode GetName retourne un objet AssemblyName qui fournit l'accès aux parties du nom complet d'un assembly.

• La méthode GetCustomAttributes répertorie les attributs appliqués à l'assembly.

• La méthode GetFiles permet d'accéder aux fichiers dans le manifeste d'assembly.

• La méthode GetManifestResourceNames fournit les noms des ressources du manifeste d'assembly.

La méthode GetTypes répertorie tous les types dans l'assembly. La méthode GetExportedTypes répertorie les types qui sont visibles par les appelants à l'extérieur de l'assembly. La méthode GetType peut être utilisée pour rechercher un type particulier dans l'assembly. La méthode CreateInstance peut être utilisée pour rechercher et créer des instances de types dans l'assembly.

Pour plus d'informations sur les assemblys, consultez Domaines d'application et assemblys.

L'exemple de code suivant montre comment obtenir l'assembly en cours d'exécution, créer une instance d'un type contenu dans cet assembly et appeler l'une des méthodes du type avec une liaison tardive. Pour cela, l'exemple de code définit une classe nommée Example, avec une méthode nommée SampleMethod. Le constructeur de la classe accepte un entier qui est utilisé pour calculer la valeur de retour de la méthode.

L'exemple de code illustre également l'utilisation de la méthode GetName pour obtenir un objet AssemblyName qui peut être utilisé pour analyser le nom complet de l'assembly. Il affiche le numéro de version de l'assembly, la propriété CodeBase et la propriété EntryPoint.

using System;
using System.Reflection;
using System.Security.Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")]

public class Example
{
    private int factor;
    public Example(int f)
    {
        factor = f;
    }

    public int SampleMethod(int x) 
    { 
        Console.WriteLine("\nExample.SampleMethod({0}) executes.", x);
        return x * factor;
    }

    public static void Main()
    {
        Assembly assem = Assembly.GetExecutingAssembly();

        Console.WriteLine("Assembly Full Name:");
        Console.WriteLine(assem.FullName);

        // The AssemblyName type can be used to parse the full name.
        AssemblyName assemName = assem.GetName();
        Console.WriteLine("\nName: {0}", assemName.Name);
        Console.WriteLine("Version: {0}.{1}", 
            assemName.Version.Major, assemName.Version.Minor);

        Console.WriteLine("\nAssembly CodeBase:");
        Console.WriteLine(assem.CodeBase);

        // Create an object from the assembly, passing in the correct number
        // and type of arguments for the constructor.
        Object o = assem.CreateInstance("Example", false, 
            BindingFlags.ExactBinding, 
            null, new Object[] { 2 }, null, null);

        // Make a late-bound call to an instance method of the object.    
        MethodInfo m = assem.GetType("Example").GetMethod("SampleMethod");
        Object ret = m.Invoke(o, new Object[] { 42 });
        Console.WriteLine("SampleMethod returned {0}.", ret);

        Console.WriteLine("\nAssembly entry point:");
        Console.WriteLine(assem.EntryPoint);
    }
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cs/source.exe

Example.SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
Void Main()
 */

.NET Framework

.NET Framework Client Profile

• SecurityAction.InheritanceDemand  

  pour une confiance totale accordée aux héritiers. Cette classe ne peut pas être héritée par du code d'un niveau de confiance partiel.

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Ce type est thread-safe.

Référence

Autres ressources