Les directives ASP.NET sont des instructions permettant de spécifier des paramètres facultatifs, tels que l'enregistrement d'un contrôle personnalisé et la langue de la page. Ces paramètres décrivent la manière dont NET Framework gère les pages Web de formulaire d'une seule page (.aspx) ou de contrôle utilisateur (.ascx).
Syntaxe de base pour émettre des commandes :
<%@ directive_name attribute=value [attribute=value] %>Dans cette section, nous présenterons les directives ASP.NET, dont la plupart seront utilisées tout au long du didacticiel.
Les directives d'application définissent des propriétés spécifiques à l'application. Il est fourni en haut du fichier global.aspx.
Syntaxe de base des instructions de candidature :
<%@ Application Language="C#" %>Propriétés de la directive d'application :
| propriété | décrire |
|---|---|
| Héritage | Hérité du nom de la classe. |
| Description | Une description textuelle de l'application. L'analyseur et le compilateur l'ignorent. |
| Langue | La langue utilisée dans le groupe de codes. |
Les directives de collection lient les composants à une page Web ou à une application pendant l'analyse. Cela peut se produire via le lien de type d'application dans un fichier Global.asax, dans un fichier d'échange, dans un contrôle utilisateur qui renvoie à une autre page Web ou dans un contrôle utilisateur.
La syntaxe de base d'un contrôle de collection est la suivante :
<%@ Assembly Name ="myassembly" %>Les propriétés du contrôle de collecte sont :
| propriété | décrire |
|---|---|
| Nom | Nom du composant de collection lié. |
| SRC | Chemin d'accès auquel les fichiers sources sont liés et modifiés dynamiquement. |
Les instructions de contrôle sont utilisées avec les contrôles utilisateur et apparaissent dans les fichiers de contrôle utilisateur (.ascx).
La syntaxe de base des instructions de contrôle est la suivante :
<%@ Control Language="C#" EnableViewState="false" %>Les propriétés des instructions de contrôle sont :
| propriété | décrire |
|---|---|
| AutoEventWireup | Valeur booléenne qui autorise ou désactive l'association automatique des gestionnaires d'événements. |
| Nom de classe | Le nom de fichier du contrôle. |
| Déboguer | Valeur booléenne qui autorise ou désactive la modification des symboles de débogage. |
| Description | Description textuelle de la page de contrôle, ignorée par le compilateur. |
| ActiverViewState | La demande de page est une valeur booléenne indiquant s'il faut conserver l'état d'affichage. |
| Explicite | En langage VB, indique à l'éditeur d'utiliser le mode d'affichage des options. |
| Héritage | Contrôlez la classe héritée par la page. |
| Langue | Langages de codage et de script. |
| SRC | Le nom de fichier de la classe code-behind. |
| Strict | En langage VB, indique à l'éditeur d'utiliser l'option Mode Standard. |
Les directives d'outils indiquent qu'une page Web, une page maître ou une page de contrôle utilisateur doit implémenter une interface .Net Framework spécifiée.
La syntaxe de base des instructions d'outil est la suivante :
<%@ Implements Interface="interface_name" %>La directive import importe un espace de noms dans une page d'une application contrôlée par l'utilisateur. Si la directive Import est spécifiée dans le fichier global.asax, elle s'applique à l'ensemble de l'application. S'il se trouve dans une page Web au sein d'une page contrôlée par l'utilisateur, il sera appliqué à cette page Web ou à ce contrôle.
La syntaxe de base de la directive import est :
<%@ namespace="System.Drawing" %>La directive main spécifie un fichier d'échange comme page d'accueil.
La syntaxe de base de l'exemple de directive de page d'accueil est :
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>La directive MasterType attribue un nom de classe à l'attribut master de la page, renforçant son type.
La syntaxe de base de la directive master est :
<%@ MasterType attribute="value"[attribute="value" ...] %>La directive de mise en cache de sortie contrôle la politique de mise en cache de sortie d'une page Web ou d'un contrôle utilisateur.
Syntaxe de base pour les instructions de mise en cache de sortie :
<%@ OutputCache Duration="15" VaryByParam="None" %>Les directives de page définissent les attributs de fichier d'échange pour des analyseurs et compilateurs de pages spécifiques.
La syntaxe de base de la directive page est :
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>Les propriétés de la directive page sont :
| propriété | décrire |
|---|---|
| AutoEventWireup | Valeur booléenne qui autorise ou désactive la liaison automatique des événements de page aux méthodes ; par exemple, Page_Load. |
| Tampon | Valeur booléenne qui autorise ou désactive la mise en mémoire tampon des réponses HTTP. |
| Nom de classe | Le nom de catégorie de la page. |
| ClientCible | Le contrôle serveur doit restituer le contenu au navigateur |
| Fichier de code | Le nom du fichier code-behind. |
| Déboguer | Valeur booléenne qui autorise ou désactive la compilation avec les symboles de débogage. |
| Description | La description du fichier de la page, ignorée par l'analyseur. |
| Activer l'état de session | Active ou désactive l'état de la session de page en lecture seule. |
| ActiverViewState | Valeur booléenne qui autorise ou interdit les requêtes interpages pour l'état d'affichage. |
| Page d'erreur | Adresse de redirection en cas d’exception de page non gérée. |
| Héritage | Le nom du code-behind ou d’une autre classe. |
| Langue | Langage de programmation de codes. |
| SRC | Le nom de fichier de la classe code-behind. |
| Tracer | Activez ou désactivez le suivi. |
| Mode Trace | Indique comment les informations de suivi sont affichées et triées par heure ou par catégorie. |
| Transaction | Indique si la transaction est prise en charge. |
| ValidateRequest | Une valeur booléenne indiquant si toutes les données d'entrée sont validement vérifiées en tant que liste codée en dur. |
La directive page précédente attribue une catégorie à une page, ce qui entraîne l'amélioration de ce type de page.
Syntaxe de base pour un exemple de la directive page précédente :
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>La directive de référence indique qu'une autre page ou un autre contrôle utilisateur doit être compilé et lié à la page actuelle.
La syntaxe de base de la directive de référence est :
<%@ Reference Page ="somepage.aspx" %>La directive d'enregistrement est utilisée pour enregistrer les contrôles serveur personnalisés et les contrôles utilisateur.
La syntaxe de base de la directive d'enregistrement est la suivante :
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>