@ Master
Mise à jour : novembre 2007
Définit des attributs spécifiques à la page maître (ficher .file) qui sont utilisés par l'analyseur et le compilateur de page ASP.NET.
<%@ Master attribute="value" [attribute="value"...] %>
Attributs
Terme |
Définition |
||
---|---|---|---|
AutoEventWireup |
Indique si les gestionnaires d'événements simples peuvent être définis pour les étapes du cycle de vie spécifiques à l'aide de la syntaxe Page sans aucun raccordement explicite ou signature d'événement. true si la connexion automatique de l'événement est activée ; sinon, false. La valeur par défaut est true. Pour plus d'informations, consultez Modèle d'événements du contrôle serveur Web ASP.NET. |
||
ClassName |
Spécifie le nom de classe pour la classe qui est générée automatiquement à partir du balisage et compilée lors du traitement de la page maître. Cette valeur peut être n'importe quel nom de classe valide et peut inclure un espace de noms. |
||
CodeFile |
Spécifie le nom d'un fichier séparé qui contient une classe partielle avec les gestionnaires d'événements et autre code spécifique à la page maître. Pour plus d'informations, consultez Modèle de code des pages Web ASP.NET. |
||
CompilationMode |
Spécifie s'il faut compiler une page maître ASP.NET au moment de l'exécution. Les options sont Always pour toujours compiler la page ; Auto, si ASP.NET consiste à éviter de compiler la page, si possible ; et Never, pour ne jamais compiler la page ou le contrôle. La valeur par défaut est Always. |
||
CompilerOptions |
Fournit une chaîne contenant des options du compilateur à utiliser pour compiler la page. En C# et en Microsoft Visual Basic, il s'agit d'une séquence de commutateurs de ligne de commande du compilateur. |
||
Debug |
Indique s'il faut compiler la page maître avec les symboles de débogage. true, pour compiler avec les symboles de débogage ; sinon, false. |
||
Description |
Fournit une description du texte de la page maître. Cette valeur est ignorée par l'analyseur ASP.NET. |
||
EnableTheming |
Indique si l'apparence de la page maître et celle des contrôles de la page maître peuvent être modifiées, si un thème est appliqué. true si un thème peut être appliqué ; sinon, false. La valeur par défaut est true. La définition de l'attribut EnableTheming est utile principalement lorsqu'un thème de page est défini dans le fichier Web.config et qu'il s'applique par défaut à toutes les pages. Pour plus d'informations, consultez Vue d'ensemble des thèmes et des apparences ASP.NET. |
||
EnableViewState |
Indique si l'état d'affichage est maintenu d'une demande de page à une autre. true pour maintenir l'état d'affichage ; sinon, false. La valeur par défaut est true. |
||
Explicit |
Détermine si la page est compilée à l'aide du mode Option Explicit de Visual Basic. true indique que l'option de compilation explicit de Visual Basic est activée et que toutes les variables doivent être déclarées à l'aide d'une instruction Dim, Private, Public ou ReDim ; sinon, false. La valeur par défaut est false.
L'attribut Explicit a la valeur true dans le fichier Machine.config. Pour plus d'informations, consultez Fichier de configuration machine. |
||
Inherits |
Spécifie une classe code-behind pour la page à hériter. Peut correspondre à toute classe dérivée de la classe MasterPage. Pour plus d'informations sur les classes code-behind, consultez Vue d'ensemble de la classe de page ASP.NET. |
||
Language |
Spécifie le langage utilisé lors de la compilation de l'ensemble des blocs de déclaration de rendu inline (<% %> et <%= %>) et de code dans la page. Les valeurs peuvent représenter tout langage pris en charge par le .NET Framework, y compris VB (Visual Basic), C# et JScript. |
||
LinePragmas |
Détermine si l'exécution doit générer des pragmas dans le code généré. |
||
MasterPageFile |
Spécifie le fichier .master qui sert de page maître pour une page maître. L'attribut MasterPageFile est utilisé dans une page maître lors de la définition d'une page maître enfant dans un scénario de page maître imbriqué. Pour plus d'informations, consultez Pages maîtres ASP.NET imbriquées. |
||
Src |
Spécifie le nom de fichier source de la classe code-behind à compiler dynamiquement lors de la demande de la page. Vous pouvez choisir d'inclure une logique de programmation pour votre page soit dans une classe code-behind soit dans un Blocs de déclaration de code du fichier .aspx. |
||
Strict |
Spécifie s'il faut compiler la page à l'aide du mode Option Strict de Visual Basic. true si Option Strict est activé ; sinon, false. La valeur par défaut est false.
|
||
WarningLevel |
Spécifie le niveau d'avertissement du compilateur auquel vous souhaitez que le compilateur abandonne la compilation de la page. Les valeurs possibles sont comprises entre 0 et 4. Pour plus d'informations, consultez WarningLevel. |
Notes
Vous pouvez utiliser la directive @ Master uniquement dans les pages maîtres. Les pages maîtres sont définies dans des fichiers dont l'extension est .master. Vous ne pouvez inclure qu'une seule directive @ Master par fichier .master.
Exemple
L'exemple de code suivant illustre comment instruire le compilateur de page ASP.NET pour utiliser Visual Basic comme langage de code incorporé. Le code de gestion d'événements est défini dans une classe partielle nommée MasterPageSample. Le code de la classe MasterPageSample se trouve dans le fichier MasterPageSample.master.vb.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>