@ Assembly

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Lie un assembly à un fichier d'application ASP.NET (une page Web, un contrôle utilisateur, une page maître ou un fichier Global.asax) pendant la compilation, rendant toutes les classes et interfaces de l'assembly accessibles.

<%@ Assembly Name="assemblyname" %>
<%@ Assembly Src="pathname" %>

Attributs

  • Name
    Chaîne qui représente le nom de l'assembly à lier.

    Notes

    Le nom de l'assembly n'inclut pas d'extension de nom de fichier.

  • Src
    Chemin vers un fichier source à compiler dynamiquement et à lier.

    Notes

    Vous devez inclure un attribut Name ou Src dans une directive @ Assembly mais vous ne pouvez pas inclure les deux à la fois dans la même directive.Si vous devez utiliser ces deux attributs, vous devez inclure plusieurs directives @ Assembly dans le fichier.

Notes

Le compilateur référence l'assembly au moment de la compilation, autorisant ainsi une liaison anticipée. Au terme de la compilation du fichier ASP.NET demandé, l'assembly est chargé dans le domaine d'application, autorisant la liaison tardive. La directive @ Assembly peut être utilisée dans les pages .aspx, les fichiers .ascx, les pages .master et les fichiers .asax.

Les assemblys qui résident dans le répertoire \Bin de votre application Web sont liés automatiquement aux fichiers ASP.NET présents dans cette application. De tels assemblys ne requièrent pas la directive @ Assembly. Vous pouvez désactiver cette fonctionnalité en supprimant la ligne suivante de la section < assemblies > du fichier Web.config de votre application :

<add assembly="*"/>

Au lieu d'utiliser la directive @ Assembly, vous pouvez aussi utiliser le fichier Web.config pour lier des assemblys dans toute une application. Pour plus d'informations sur le fichier Web.config et la configuration de votre application, consultez ASP.NET Configuration Overview et assemblies, élément de compilation (Schéma des paramètres ASP.NET).

Exemple

L'exemple de code suivant utilise deux directives @ Assembly, la première pour créer une liaison à MyAssembly, un assembly défini par l'utilisateur, et la seconde pour créer une liaison à MySource.vb, un fichier source Visual Basic.

<%@ Assembly Name="MyAssembly" %>
<%@ Assembly Src="MySource.vb" %>

Voir aussi

Référence

Syntaxe des directives de modèles de texte

assemblies, élément de compilation (Schéma des paramètres ASP.NET)

Concepts

ASP.NET Web Page Syntax Overview