@ Master
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Definiert masterseitenspezifische Attribute (MASTER-Datei), die vom ASP.NET-Seitenparser und dem Compiler verwendet werden.
<%@ Master attribute="value" [attribute="value"...] %>
Attribute
Begriff |
Definition |
|---|---|
AutoEventWireup |
Gibt an, ob einfache Ereignishandler für bestimmte Lebenszyklusstadien mithilfe der Syntax Page ohne eine explizite Verknüpfungs- oder Ereignissignatur definiert werden können. true, wenn die automatische Verknüpfung von Ereignissen aktiviert ist, andernfalls false. Die Standardeinstellung ist true. Weitere Informationen finden Sie unter ASP.NET Web Server Control Event Model. |
ClassName |
Gibt den Klassennamen der Klasse an, die automatisch aus dem Markup generiert und bei der Verarbeitung der Masterseite kompiliert wird. Dieser Wert kann ein beliebiger Klassenname sein und kann auch einen Namespace enthalten. |
CodeFile |
Gibt den Namen einer separaten Datei an, die eine partielle Klasse mit den Ereignishandlern und anderem masterseitenspezifischem Code enthält. Weitere Informationen finden Sie unter ASP.NET Web Page Code Model . |
CompilationMode |
Gibt an, ob eine ASP.NET-Masterseite zur Laufzeit kompiliert werden soll. Die Optionen sind Always, wenn die Seite immer kompiliert werden soll; Auto, wenn ASP.NET das Kompilieren der Seite vermeiden soll, sofern möglich; und Never, wenn die Seite oder das Steuerelement nie kompiliert werden sollen. Der Standardwert ist Always. |
CompilerOptions |
Stellt eine Zeichenfolge mit Compileroptionen bereit, die zum Kompilieren der Seite verwendet werden sollen. In C# und Microsoft Visual Basic ist dies eine Sequenz von Compiler-Befehlszeilenschaltern. |
Debug |
Gibt an, ob die Masterseite mit Debugsymbolen kompiliert werden soll. true, um mit Debugsymbolen zu kompilieren, andernfalls false. |
Description |
Stellt eine Textbeschreibung der Masterseite bereit. Dieser Wert wird vom ASP.NET-Parser ignoriert. |
EnableTheming |
Gibt an, ob die Darstellung der Gestaltungsvorlage und von Steuerelementen auf der Gestaltungsvorlage geändert werden kann, wenn ein Design angewendet wird. true, wenn ein Design angewendet werden kann, andernfalls false. Die Standardeinstellung ist true. Das Festlegen des EnableTheming-Attributs ist in erster Linie dann hilfreich, wenn ein Seitendesign in der Datei Web.config definiert wird und standardmäßig für alle Seiten gilt. Weitere Informationen finden Sie unter: ASP.NET Themes Overview. |
EnableViewState |
Gibt an, ob der Ansichtszustand über Seitenanforderungen hinweg erhalten bleibt. true, um den Ansichtszustand beizubehalten, andernfalls false. Die Standardeinstellung ist true. |
Explicit |
Bestimmt, ob die Seite mithilfe des Option Explicit-Modus von Visual Basic kompiliert wird. true gibt an, dass die explizite Kompilierungsoption von Visual Basic aktiviert ist und dass alle Variablen mithilfe einer der Anweisungen Dim, Private, Public oder ReDim deklariert werden müssen; andernfalls false. Die Standardeinstellung ist false. .gif "Note") Note
Das Explicit-Attribut wird von allen anderen Sprachen außer Visual Basic ignoriert.
Das Explicit-Attribut ist in der Datei Machine.config auf true festgelegt. Weitere Informationen finden Sie unter Machine Configuration Files. |
Inherits |
Gibt eine CodeBehind-Klasse für die zu erbende Seite an. Dies kann jede von der MasterPage-Klasse abgeleitete Klasse sein. Informationen zu CodeBehind-Klassen finden Sie unter ASP.NET Page Class Overview. |
Language |
Gibt die Sprache an, die beim Kompilieren aller Inlineausgaben (<% %> und <%= %>) und Codedeklarationsblöcke auf der Seite verwendet wird. Jede von .NET Framework unterstützte Sprache kann durch Werte dargestellt werden, einschließlich VB (Visual Basic), C# und JScript. |
LinePragmas |
Bestimmt, ob die Laufzeit Pragmas im generierten Code erstellen soll. |
MasterPageFile |
Gibt die MASTER-Datei an, die für eine Masterseite als Masterseite fungiert. Das MasterPageFile-Attribut wird auf einer Masterseite beim Definieren einer untergeordneten Masterseite in einem geschachtelten Masterseiten-Szenario verwendet. Ausführliche Informationen finden Sie unter Nested ASP.NET Master Pages. |
Src |
Gibt den Namen der Quelldatei der CodeBehind-Klasse an, die für das dynamische Kompilieren bei Anforderung einer Seite erforderlich ist. Sie können Programmierlogik für die Seite in einer CodeBehind-Klasse oder in Codedeklarationsblöcke in der ASPX-Datei einfügen. |
Strict |
Gibt an, ob die Seite mithilfe des Option Strict-Modus von Visual Basic kompiliert werden soll. true, wenn Option Strict aktiviert ist, andernfalls false. Die Standardeinstellung ist false. Note
Das Strict-Attribut wird von allen anderen Sprachen außer Visual Basic ignoriert.
|
WarningLevel |
Gibt die Warnstufe des Compilers an, bei der der Compiler das Kompilieren der Seite abbrechen soll. Mögliche Werte liegen zwischen 0 und 4. Weitere Informationen finden Sie unter WarningLevel. |
Hinweise
Die @ Master-Direktive kann nur auf Masterseiten verwendet werden. Masterseiten werden in Dateien mit der Erweiterung .master definiert. Sie können pro MASTER-Datei nur eine @ Master-Direktive einschließen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie der ASP.NET-Seitencompiler angewiesen wird, Visual Basic als Inlinecodesprache zu verwenden. Der Ereignisbehandlungscode wird in der partiellen Klasse MasterPageSample definiert. Der Code für die MasterPageSample-Klasse befindet sich in der Datei MasterPageSample.master.vb.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>
Siehe auch
Konzepte
ASP.NET Web Page Syntax Overview