Assembly Classe
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.
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime.
public ref class Assembly abstract
public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable
public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider
public ref class Assembly : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory
public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory
public abstract class Assembly
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable
public abstract class Assembly : System.Reflection.ICustomAttributeProvider
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory
type Assembly = class
type Assembly = class
interface ICustomAttributeProvider
interface ISerializable
type Assembly = class
interface ICustomAttributeProvider
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Assembly = class
interface _Assembly
interface IEvidenceFactory
interface ICustomAttributeProvider
interface ISerializable
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Assembly = class
interface _Assembly
interface IEvidenceFactory
interface ICustomAttributeProvider
interface ISerializable
Public MustInherit Class Assembly
Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable
Public MustInherit Class Assembly
Implements ICustomAttributeProvider
Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable
Public MustInherit Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable
- Héritage
-
Assembly
- Dérivé
- Attributs
- Implémente
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. À cet effet, 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, 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. L’exemple affiche le numéro de version de l’assembly, la propriété CodeBase et la propriété EntryPoint.
using namespace System;
using namespace System::Reflection;
using namespace System::Security::Permissions;
[assembly:AssemblyVersionAttribute("1.0.2000.0")];
public ref class Example
{
private:
int factor;
public:
Example(int f)
{
factor = f;
}
int SampleMethod(int x)
{
Console::WriteLine("\nExample->SampleMethod({0}) executes.", x);
return x * factor;
}
};
void main()
{
Assembly^ assem = Example::typeid->Assembly;
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,
nullptr, gcnew array<Object^> { 2 }, nullptr, nullptr);
// Make a late-bound call to an instance method of the object.
MethodInfo^ m = assem->GetType("Example")->GetMethod("SampleMethod");
Object^ ret = m->Invoke(o, gcnew array<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/cpp/source.exe
Example->SampleMethod(42) executes.
SampleMethod returned 84.
Assembly entry point:
UInt32 _mainCRTStartup()
*/
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 = typeof(Example).Assembly;
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()
*/
Imports System.Reflection
Imports System.Security.Permissions
<assembly: AssemblyVersionAttribute("1.0.2000.0")>
Public Class Example
Private factor As Integer
Public Sub New(ByVal f As Integer)
factor = f
End Sub
Public Function SampleMethod(ByVal x As Integer) As Integer
Console.WriteLine(vbCrLf & "Example.SampleMethod({0}) executes.", x)
Return x * factor
End Function
Public Shared Sub Main()
Dim assem As Assembly = GetType(Example).Assembly
Console.WriteLine("Assembly Full Name:")
Console.WriteLine(assem.FullName)
' The AssemblyName type can be used to parse the full name.
Dim assemName As AssemblyName = assem.GetName()
Console.WriteLine(vbLf + "Name: {0}", assemName.Name)
Console.WriteLine("Version: {0}.{1}", assemName.Version.Major, _
assemName.Version.Minor)
Console.WriteLine(vbLf + "Assembly CodeBase:")
Console.WriteLine(assem.CodeBase)
' Create an object from the assembly, passing in the correct number
' and type of arguments for the constructor.
Dim o As Object = assem.CreateInstance("Example", False, _
BindingFlags.ExactBinding, Nothing, _
New Object() { 2 }, Nothing, Nothing)
' Make a late-bound call to an instance method of the object.
Dim m As MethodInfo = assem.GetType("Example").GetMethod("SampleMethod")
Dim ret As Object = m.Invoke(o, New Object() { 42 })
Console.WriteLine("SampleMethod returned {0}.", ret)
Console.WriteLine(vbCrLf & "Assembly entry point:")
Console.WriteLine(assem.EntryPoint)
End Sub
End Class
' 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/vb/source.exe
'
'Example.SampleMethod(42) executes.
'SampleMethod returned 84.
'
'Assembly entry point:
'Void Main()
'
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 les 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 dynamiquement des assemblys, la classe Assembly fournit les méthodes statiques suivantes (Shared
méthodes en Visual Basic). Les assemblys sont chargés dans le domaine d’application où l’opération de chargement se produit.
La méthode 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 Comment le runtime localise les assemblys.
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 le code qui s’exécute sur une plateforme 32 bits.
Les méthodes LoadFile et LoadFrom sont fournies pour les scénarios rares dans lesquels un assembly doit être identifié par 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 d’affichage de l’assembly.
La méthode GetCustomAttributes répertorie les attributs appliqués à l’assembly.
La méthode GetFiles permet d’accéder aux fichiers du manifeste d’assembly.
La méthode GetManifestResourceNames fournit les noms des ressources dans le manifeste d’assembly.
La méthode GetTypes répertorie tous les types de l’assembly. La méthode GetExportedTypes répertorie les types visibles par les appelants en dehors 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 la section « Domaines et assemblys d’application » dans la rubrique Domaines d’application.
Assembly() |
Initialise une nouvelle instance de la classe Assembly. |
Code |
Obsolète.
Obsolète.
Obtient l’emplacement de l’assembly comme spécifié à l’origine, par exemple dans un objet AssemblyName. |
Custom |
Obtient une collection qui contient les attributs personnalisés de cet assembly. |
Defined |
Obtient une collection des types définis dans cet assembly. |
Entry |
Obtient le point d’entrée de cet assembly. |
Escaped |
Obsolète.
Obsolète.
Obtient l’URI, y compris les caractères d’échappement, qui représente la base de code. |
Evidence |
Obtient la preuve de cet assembly. |
Exported |
Obtient une collection des types publics définis dans cet assembly qui sont visibles en dehors de l’assembly. |
Full |
Obtient le nom complet de l’assembly. |
Global |
Obsolète.
Obtient une valeur indiquant si l’assembly a été chargé à partir du Global Assembly Cache (.NET Framework uniquement). |
Host |
Obtient le contexte hôte avec lequel l’assembly a été chargé. |
Image |
Obtient une chaîne représentant la version du Common Language Runtime (CLR) enregistrée dans le fichier contenant le manifeste. |
Is |
Obtient une valeur qui indique si cet assembly est conservé dans un AssemblyLoadContextcollectible. |
Is |
Obtient une valeur qui indique si l’assembly actuel a été généré dynamiquement dans le processus actuel à l’aide de l’émission de réflexion. |
Is |
Obtient une valeur qui indique si l’assembly actuel est chargé avec une confiance totale. |
Location |
Obtient le chemin d’accès complet ou l’emplacement UNC du fichier chargé qui contient le manifeste. |
Manifest |
Obtient le module qui contient le manifeste de l’assembly actuel. |
Modules |
Obtient une collection qui contient les modules de cet assembly. |
Permission |
Obtient le jeu d’octroi de l’assembly actuel. |
Reflection |
Obtient une valeur Boolean indiquant si cet assembly a été chargé dans le contexte de réflexion uniquement. |
Security |
Obtient une valeur qui indique l’ensemble de règles de sécurité appliquées par le Common Language Runtime (CLR) pour cet assembly. |
Create |
Localise le type spécifié à partir de cet assembly et crée une instance de celui-ci à l’aide de l’activateur système, à l’aide de la recherche sensible à la casse. |
Create |
Recherche le type spécifié à partir de cet assembly et crée une instance de celui-ci à l’aide de l’activateur système, avec une recherche facultative sensible à la casse. |
Create |
Recherche le type spécifié à partir de cet assembly et crée une instance de celui-ci à l’aide de l’activateur système, avec recherche facultative sensible à la casse et ayant la culture, les arguments et les attributs d’activation et de liaison spécifiés. |
Create |
Crée le nom d’un type qualifié par le nom complet de son assembly. |
Equals(Object) |
Détermine si cet assembly et l’objet spécifié sont égaux. |
Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
Get |
Obtient l’assembly actuellement chargé dans lequel le type spécifié est défini. |
Get |
Retourne la Assembly de la méthode qui a appelé la méthode en cours d’exécution. |
Get |
Obtient tous les attributs personnalisés pour cet assembly. |
Get |
Obtient les attributs personnalisés pour cet assembly, comme spécifié par type. |
Get |
Retourne des informations sur les attributs qui ont été appliqués au Assemblyactuel, exprimées sous forme d’objets CustomAttributeData. |
Get |
Obtient l’assembly d’entrée pour l’application en cours d’exécution. |
Get |
Obtient l’assembly qui contient le code en cours d’exécution. |
Get |
Obtient les types publics définis dans cet assembly qui sont visibles en dehors de l’assembly. |
Get |
Obtient une FileStream pour le fichier spécifié dans la table de fichiers du manifeste de cet assembly. |
Get |
Obtient les fichiers dans la table de fichiers d’un manifeste d’assembly. |
Get |
Obtient les fichiers dans la table de fichiers d’un manifeste d’assembly, en spécifiant s’il faut inclure des modules de ressources. |
Get |
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime. |
Get |
Retourne le code de hachage pour cette instance. |
Get |
Sert de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient tous les modules chargés qui font partie de cet assembly. |
Get |
Obtient tous les modules chargés qui font partie de cet assembly, en spécifiant s’il faut inclure des modules de ressources. |
Get |
Retourne des informations sur la façon dont la ressource donnée a été conservée. |
Get |
Retourne les noms de toutes les ressources de cet assembly. |
Get |
Charge la ressource de manifeste spécifiée à partir de cet assembly. |
Get |
Charge la ressource de manifeste spécifiée, délimitée par l’espace de noms du type spécifié, à partir de cet assembly. |
Get |
Obtient le module spécifié dans cet assembly. |
Get |
Obtient tous les modules qui font partie de cet assembly. |
Get |
Obtient tous les modules qui font partie de cet assembly, en spécifiant s’il faut inclure des modules de ressources. |
Get |
Obtient une AssemblyName pour cet assembly. |
Get |
Obtient une AssemblyName pour cet assembly, en définissant la base de code comme spécifié par |
Get |
Obsolète.
Obtient des informations de sérialisation avec toutes les données nécessaires pour réinstancier cet assembly. |
Get |
Obtient les objets AssemblyName pour tous les assemblys référencés par cet assembly. |
Get |
Obtient l’assembly satellite pour la culture spécifiée. |
Get |
Obtient la version spécifiée de l’assembly satellite pour la culture spécifiée. |
Get |
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime. |
Get |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
Get |
Obtient l’objet Type avec le nom spécifié dans l’instance d’assembly. |
Get |
Obtient l’objet Type portant le nom spécifié dans l’instance d’assembly et lève éventuellement une exception si le type est introuvable. |
Get |
Obtient l’objet Type portant le nom spécifié dans l’instance d’assembly, avec les options d’ignorer le cas et de lever une exception si le type est introuvable. |
Get |
Obtient tous les types définis dans cet assembly. |
Is |
Indique si un attribut spécifié a été appliqué ou non à l’assembly. |
Load(Assembly |
Charge un assembly en fonction de son AssemblyName. |
Load(Assembly |
Obsolète.
Charge un assembly en fonction de son AssemblyName. L’assembly est chargé à l’aide de la preuve fournie. |
Load(Byte[]) |
Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis. |
Load(Byte[], Byte[]) |
Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis, y compris éventuellement des symboles pour l’assembly. |
Load(Byte[], Byte[], Evidence) |
Obsolète.
Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis, y compris éventuellement des symboles et des preuves pour l’assembly. |
Load(Byte[], Byte[], Security |
Charge l’assembly avec une image COFF (Common Object File Format) contenant un assembly émis, y compris éventuellement des symboles et en spécifiant la source pour le contexte de sécurité. |
Load(String) |
Charge un assembly avec le nom spécifié. |
Load(String, Evidence) |
Obsolète.
Charge un assembly en fonction de son nom complet et utilise la preuve fournie. |
Load |
Charge le contenu d’un fichier d’assembly sur le chemin d’accès spécifié. |
Load |
Obsolète.
Charge un assembly en fonction de son chemin d’accès, en chargeant l’assembly à l’aide de la preuve fournie. |
Load |
Charge un assembly en fonction de son nom de fichier ou de son chemin d’accès. |
Load |
Obsolète.
Charge un assembly en fonction du nom de fichier ou du chemin d’accès, de la valeur de hachage et de l’algorithme de hachage. |
Load |
Obsolète.
Charge un assembly en fonction de son nom de fichier ou de son chemin d’accès et fournit des preuves de sécurité. |
Load |
Obsolète.
Charge un assembly en fonction de son nom de fichier ou de son chemin d’accès, de la preuve de sécurité, de la valeur de hachage et de l’algorithme de hachage. |
Load |
Charge le module, interne à cet assembly, avec une image COFF (Common Object File Format) contenant un module émis ou un fichier de ressources. |
Load |
Charge le module, interne à cet assembly, avec une image COFF (Common Object File Format) contenant un module émis ou un fichier de ressources. Les octets bruts représentant les symboles du module sont également chargés. |
Load |
Obsolète.
Obsolète.
Obsolète.
Charge un assembly à partir du répertoire de l’application ou du Global Assembly Cache à l’aide d’un nom partiel. |
Load |
Obsolète.
Charge un assembly à partir du répertoire de l’application ou du Global Assembly Cache à l’aide d’un nom partiel. L’assembly est chargé à l’aide de la preuve fournie. |
Memberwise |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
Reflection |
Obsolète.
Charge l’assembly à partir d’une image COFF (Common Object File Format) contenant un assembly émis. L’assembly est chargé dans le contexte de réflexion uniquement du domaine d’application de l’appelant. |
Reflection |
Obsolète.
Charge un assembly dans le contexte de réflexion uniquement, en fonction de son nom complet. |
Reflection |
Obsolète.
Charge un assembly dans le contexte de réflexion uniquement, en fonction de son chemin d’accès. |
Set |
Définit l’assembly d’entrée de l’application sur l’objet assembly fourni. |
To |
Retourne le nom complet de l’assembly, également appelé nom d’affichage. |
Unsafe |
Charge un assembly dans le contexte de chargement à partir du contexte, en contournant certaines vérifications de sécurité. |
Equality(Assembly, Assembly) |
Indique si deux objets Assembly sont égaux. |
Inequality(Assembly, Assembly) |
Indique si deux objets Assembly ne sont pas égaux. |
Module |
Se produit lorsque le chargeur de classe Common Language Runtime ne peut pas résoudre une référence à un module interne d’un assembly par le biais de moyens normaux. |
_Assembly. |
Retourne le type de l’instance actuelle. |
ICustom |
Retourne un tableau de tous les attributs personnalisés définis sur ce membre, à l’exclusion des attributs nommés ou d’un tableau vide s’il n’existe aucun attribut personnalisé. |
ICustom |
Retourne un tableau d’attributs personnalisés définis sur ce membre, identifiés par type ou un tableau vide s’il n’existe aucun attribut personnalisé de ce type. |
ICustom |
Indique si une ou plusieurs instances de |
Get |
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime. |
Get |
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime. |
Get |
Représente un assembly, qui est un bloc de construction réutilisable, versionable et auto-décrivant une application Common Language Runtime. |
Get |
Récupère un attribut personnalisé d’un type spécifié appliqué à un assembly spécifié. |
Get |
Récupère un attribut personnalisé d’un type spécifié appliqué à un assembly spécifié. |
Get |
Récupère une collection d’attributs personnalisés appliqués à un assembly spécifié. |
Get |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un assembly spécifié. |
Get |
Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un assembly spécifié. |
Is |
Indique si les attributs personnalisés d’un type spécifié sont appliqués à un assembly spécifié. |
Try |
Récupère la section de métadonnées de l’assembly, à utiliser avec MetadataReader. |
Produit | Versions |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Ce type est thread safe.
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :