Partager via


Syntaxe de directive

Mise à jour : novembre 2007

Spécifie des paramètres utilisés par les compilateurs de pages et de contrôles utilisateur lorsqu'ils traitent des fichiers de page Web Forms ASP.NET (.aspx) et des fichiers de contrôle utilisateur (.ascx).

Notes

Lorsque des directives sont utilisées, elles peuvent figurer à n'importe quel emplacement dans un fichier .aspx ou .ascx, même si elles sont, dans la pratique, généralement incluses au début du fichier. Chaque directive peut contenir un ou plusieurs attributs (associés à des valeurs) qui sont spécifiques à cette directive.

Remarque :

La directive @ Page peut être utilisée uniquement dans des fichiers .aspx et la directive @ Control uniquement dans les fichiers .ascx.

L'infrastructure de page ASP.NET prend en charge les directives suivantes.

@ Page

Définit des attributs spécifiques aux pages utilisés par le compilateur et l'analyseur de pages ASP.NET. Ne peut être inclus que dans des fichiers .aspx.

@ Control

Définit des attributs spécifiques aux contrôles utilisés par le compilateur et l'analyseur de pages ASP.NET. Ne peut être inclus que dans des fichiers .ascx (contrôles utilisateur).

@ Import

Importe de manière explicite un espace de noms dans une page ou un contrôle utilisateur.

@ Implements

Indique de manière déclarative qu'une page ou un contrôle utilisateur implémente une interface .NET Framework spécifiée.

@ Register

Associe des alias aux espaces de noms et aux noms de classes, assurant ainsi le rendu des contrôles utilisateur et des contrôles serveur personnalisés lorsqu'ils sont inclus dans la page ou le contrôle utilisateur demandé.

@ Assembly

Lie un assembly à la page active lors de la compilation, rendant ainsi toutes les classes et les interfaces de l'assembly utilisables sur la page.

@ Master

Identifie une page maître ASP.NET.

@ WebHandler

Identifie une page IHttpHandler ASP.NET.

@ PreviousPageType

Permet d'obtenir le typage fort de la page précédente, accédée via la propriété PreviousPage.

@ MasterType

Affecte un nom de classe à la propriété Master d'une page ASP.NET, afin que la page puisse obtenir des références fortement typées à des membres de la page maître.

@ OutputCache

Contrôle de manière déclarative les politiques de mise en cache de sortie d'une page ou d'un contrôle utilisateur.

@ Reference

Lie de manière déclarative une page ou un contrôle utilisateur à la page ou au contrôle utilisateur actif.

ASP.NET considère tout bloc de directive (<%@ %>) dépourvu d'un nom de directive explicite comme une directive @ Page (dans le cas d'une page) ou comme une directive @ Control (dans le cas d'un contrôle utilisateur).

Voir aussi

Référence

Page

Autres ressources

Syntaxe de page ASP.NET