Freigeben über


Direktivensyntax

Aktualisiert: November 2007

Gibt die Einstellungen an, die von den Compilern für Seiten und Benutzersteuerelemente bei der Verarbeitung von Web Forms-Seitendateien (.aspx) und Benutzersteuerelementdateien (.ascx) in ASP.NET verwendet werden.

Hinweise

Wenn Direktiven verwendet werden, können diese an einer beliebigen Stelle in einer ASPX- oder ASCX-Datei platziert werden. Üblicherweise werden sie jedoch am Anfang der Datei eingefügt. Jede Direktive kann ein oder mehrere Attribute enthalten (jeweils mit einem Wert), die für diese Direktive spezifisch sind.

Tipp

Die @ Page-Direktive kann nur in ASPX-Dateien und die @ Control-Direktive nur in ASCX-Dateien verwendet werden.

Das ASP.NET-Seitenframework unterstützt die folgenden Direktiven.

@ Page

Definiert seitenspezifische Attribute, die vom Parser und vom Compiler der ASP.NET-Seite verwendet werden. Kann nur in ASPX-Dateien eingefügt werden.

@ Control

Definiert steuerelementspezifische Attribute, die vom Parser und vom Compiler der ASP.NET-Seite verwendet werden. Kann nur in ASCX-Dateien (Benutzersteuerelemente) eingefügt werden.

@ Import

Importiert einen Namespace explizit in eine Seite oder ein Benutzersteuerelement.

@ Implements

Gibt deklarativ an, dass eine Seite oder ein Benutzersteuerelement eine angegebene .NET Framework-Schnittstelle implementiert.

@ Register

Ordnet Aliasen Namespaces und Klassennamen zu, wobei auch Benutzersteuerelemente und benutzerdefinierte Serversteuerelemente dargestellt werden können, wenn diese auf einer angeforderten Seite oder in einem Benutzersteuerelement enthalten sind.

@ Assembly

Verknüpft eine Assembly während der Kompilierung mit der aktuellen Seite, wodurch alle Klassen und Schnittstellen der Assembly auf der Seite verfügbar gemacht werden.

@ Master

Identifiziert eine ASP.NET-Masterseite.

@ WebHandler

Identifiziert eine ASP.NET-IHttpHandler-Seite.

@ PreviousPageType

Bietet die Möglichkeit einer starken Typisierung für die vorherige Seite, auf die durch die PreviousPage-Eigenschaft zugegriffen wird.

@ MasterType

Weist der Master-Eigenschaft einer ASP.NET-Seite einen Klassennamen zu, sodass die Seite streng typisierte Verweise auf Member der Masterseite erhalten kann.

@ OutputCache

Steuert deklarativ die Richtlinien für Ausgabecaches für eine Seite oder ein Benutzersteuerelement.

@ Reference

Verknüpft eine Seite oder ein Benutzersteuerelement deklarativ mit der aktuellen Seite oder dem aktuellen Benutzersteuerelement.

ASP.NET behandelt Direktivenblöcke (<%@ %>), die keinen expliziten Direktivennamen enthalten, als @ Page-Direktive für eine Seite oder als @ Control-Direktive für ein Benutzersteuerelement.

Siehe auch

Referenz

Page

Weitere Ressourcen

Syntax von ASP.NET-Seiten