ASP.NET-Direktiven sind Anweisungen zum Angeben optionaler Einstellungen, z. B. zum Registrieren eines benutzerdefinierten Steuerelements und der Sprache der Seite. Diese Einstellungen beschreiben, wie das NET Framework Einzelseitenformular-Webseiten (.aspx) oder Benutzersteuerungswebseiten (.ascx) verarbeitet.
Grundlegende Syntax zum Ausgeben von Befehlen:
<%@ directive_name attribute=value [attribute=value] %>In diesem Abschnitt stellen wir ASP.NET-Direktiven vor, von denen die meisten im gesamten Tutorial verwendet werden.
Anwendungsdirektiven definieren anwendungsspezifische Eigenschaften. Es befindet sich oben in der Datei global.aspx.
Grundlegende Syntax von Anwendungsanweisungen:
<%@ Application Language="C#" %>Eigenschaften der Anwendungsrichtlinie:
| Eigentum | beschreiben |
|---|---|
| Erbt | Vom Namen der Klasse geerbt. |
| Beschreibung | Eine Textbeschreibung der Anwendung. Der Parser und Compiler ignorieren dies. |
| Sprache | Die in der Codegruppe verwendete Sprache. |
Sammlungsanweisungen verknüpfen Komponenten während der Analyse mit einer Webseite oder Anwendung. Dies kann im gesamten Anwendungstyplink in einer Global.asax-Datei, in einer Auslagerungsdatei, in einem Benutzersteuerelement, das auf eine andere Webseite verweist, oder in einem Benutzersteuerelement auftreten.
Die grundlegende Syntax eines Sammlungssteuerelements lautet:
<%@ Assembly Name ="myassembly" %>Die Eigenschaften des Sammlungssteuerelements sind:
| Eigentum | beschreiben |
|---|---|
| Name | Der Name der verknüpften Sammlungskomponente. |
| Src | Der Pfad, mit dem Quelldateien dynamisch verknüpft und bearbeitet werden. |
Steueranweisungen werden mit Benutzersteuerelementen verwendet und erscheinen in Benutzersteuerelementdateien (.ascx).
Die grundlegende Syntax von Steueranweisungen ist:
<%@ Control Language="C#" EnableViewState="false" %>Die Eigenschaften der Steueranweisungen sind:
| Eigentum | beschreiben |
|---|---|
| AutoEventWireup | Boolescher Wert, der die automatische Zuordnung von Ereignishandlern ermöglicht oder deaktiviert. |
| Klassenname | Der Dateiname des Steuerelements. |
| Debuggen | Boolescher Wert, der die Bearbeitung von Debugsymbolen ermöglicht oder deaktiviert. |
| Beschreibung | Textbeschreibung der Steuerseite, vom Compiler ignoriert. |
| EnableViewState | Die Seitenanforderung ist ein boolescher Wert, der angibt, ob der Ansichtsstatus beibehalten werden soll. |
| Explizit | Weist den Editor in der VB-Sprache an, den Optionsanzeigemodus zu verwenden. |
| Erbt | Steuern Sie die von der Seite geerbte Klasse. |
| Sprache | Codierungs- und Skriptsprachen. |
| Src | Der Dateiname der Code-Behind-Klasse. |
| Strikt | Weist den Editor in der VB-Sprache an, die Option „Standardmodus“ zu verwenden. |
Toolanweisungen geben an, dass eine Webseite, Masterseite oder Benutzersteuerungsseite eine bestimmte .Net Framework-Schnittstelle implementieren muss.
Die grundlegende Syntax von Werkzeuganweisungen lautet:
<%@ Implements Interface="interface_name" %>Die Importanweisung importiert einen Namespace in eine Seite einer benutzergesteuerten Anwendung. Wenn die Import-Direktive in der Datei global.asax angegeben ist, gilt sie für die gesamte Anwendung. Wenn es sich auf einer Webseite innerhalb einer benutzergesteuerten Seite befindet, wird es auf diese Webseite oder dieses Steuerelement angewendet.
Die grundlegende Syntax der Importanweisung lautet:
<%@ namespace="System.Drawing" %>Die Hauptanweisung gibt eine Auslagerungsdatei als Startseite an.
Die grundlegende Syntax der Beispiel-Homepage-Direktive lautet:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>Die MasterType-Direktive weist dem Master-Attribut der Seite einen Klassennamen zu und verstärkt so ihren Typ.
Die grundlegende Syntax der Master-Direktive lautet:
<%@ MasterType attribute="value"[attribute="value" ...] %>Die Ausgabe-Caching-Direktive steuert die Ausgabe-Caching-Richtlinie einer Webseite oder eines Benutzersteuerelements.
Grundlegende Syntax für Ausgabe-Caching-Anweisungen:
<%@ OutputCache Duration="15" VaryByParam="None" %>Seitendirektiven definieren Seitendateiattribute für bestimmte Seitenparser und Compiler.
Die grundlegende Syntax der Seitenanweisung lautet:
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>Die Eigenschaften der Seitenanweisung sind:
| Eigentum | beschreiben |
|---|---|
| AutoEventWireup | Boolescher Wert, der die automatische Bindung von Seitenereignissen an Methoden ermöglicht oder deaktiviert; |
| Puffer | Boolescher Wert, der die HTTP-Antwortpufferung zulässt oder deaktiviert. |
| Klassenname | Der Kategoriename der Seite. |
| ClientTarget | Die Serversteuerung sollte Inhalte für den Browser rendern |
| Codedatei | Der Name der Code-Behind-Datei. |
| Debuggen | Boolescher Wert, der die Kompilierung mit Debugsymbolen zulässt oder deaktiviert. |
| Beschreibung | Die Dateibeschreibung der Seite, vom Parser ignoriert. |
| EnableSessionState | Aktiviert oder deaktiviert den Seitensitzungsstatus als schreibgeschützt. |
| EnableViewState | Ein boolescher Wert, der seitenübergreifende Anforderungen für den Ansichtsstatus zulässt oder nicht zulässt. |
| Fehlerseite | Umleitungsadresse im Falle einer nicht behandelten Seitenausnahme. |
| Erbt | Der Name der Code-Behind-Klasse oder einer anderen Klasse. |
| Sprache | Code-Programmiersprache. |
| Src | Der Dateiname der Code-Behind-Klasse. |
| Verfolgen | Tracking aktivieren oder deaktivieren. |
| TraceMode | Gibt an, wie Tracking-Informationen angezeigt und nach Zeit oder Kategorie sortiert werden. |
| Transaktion | Gibt an, ob die Transaktion unterstützt wird. |
| ValidateRequest | Ein boolescher Wert, der angibt, ob alle Eingabedaten gültig als hartcodierte Liste überprüft wurden. |
Die vorherige Seitenanweisung weist einer Seite eine Kategorie zu, wodurch dieser Seitentyp erweitert wird.
Grundlegende Syntax für ein Beispiel der vorherigen Seitenanweisung:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>Die Referenzanweisung gibt an, dass eine andere Seite oder ein Benutzersteuerelement kompiliert und mit der aktuellen Seite verknüpft werden soll.
Die grundlegende Syntax der Referenzanweisung lautet:
<%@ Reference Page ="somepage.aspx" %>Die Registrierungsanweisung wird zum Registrieren benutzerdefinierter Serversteuerelemente und Benutzersteuerelemente verwendet.
Die grundlegende Syntax der Registrierungsanweisung lautet:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>