@ Master
[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.]
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 des gestionnaires d'événements simples peuvent être définis pour des étapes du cycle de vie spécifiques à l'aide de la syntaxe Page sans aucune connexion explicite ni signature d'événement. true si la connexion automatique d'événement est activée ; sinon, false. La valeur par défaut est true. Pour plus d'informations, consultez ASP.NET Web Server Control Event Model. |
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 ASP.NET Web Page Code Model. |
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 des contrôles de la page maître peut être modifiée, dans la mesure où 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 ASP.NET Themes Overview. |
EnableViewState |
Indique si l'état d'affichage est maintenu d'une requête 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 explicite 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. .gif "Note") Note
L'attribut Explicit est ignoré par les langages autres que Visual Basic.
L'attribut Explicit a la valeur true dans le fichier Machine.config. Pour plus d'informations, consultez Machine Configuration Files. |
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 ASP.NET Page Class Overview. |
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 Nested ASP.NET Master Pages. |
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 si la page doit être compilée à l'aide du mode Option Strict de Visual Basic. true si Option Strict est activé ; sinon, false. La valeur par défaut est false. Note
L'attribut Strict est ignoré par les langages autres que Visual Basic.
|
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" %>
Voir aussi
Concepts
ASP.NET Web Page Syntax Overview