@ WebHandler
Aktualisiert: November 2007
Definiert Attribute und Kompilierungsoptionen für HTTP-Handlerdateien (.ashx).
<%@ WebHandler attribute="value" [attribute="value"...] %>
Attribute
Class
Gibt den Namen der Klasse an, die dynamisch kompiliert wird, wenn der Handler angefordert wird. Dieser Wert kann auf jede Klasse verweisen, die von IHttpHandler erbt, und kann einen vollqualifizierten Klassennamen enthalten.CodeBehind
Gibt den Namen der kompilierten Datei an, in der die Klasse enthalten ist, die dem Handler zugeordnet ist. Dieses Attribut wird zur Laufzeit nicht verwendet.Tipp
Dieses Attribut dient zur Kompatibilität mit früheren Versionen von ASP.NET.
CompilerOptions
Gibt eine Zeichenfolge an, die Optionen enthält, die zum Kompilieren des Handlers verwendet werden. In C# und Visual Basic ist dies eine Sequenz von Compiler-Befehlszeilenschaltern. Weitere Informationen zu Compileroptionen finden Sie unter C#-Compileroptionen und Visual Basic-Compiler.Debug
Lautet true, wenn der Handler mit Debugsymbolen kompiliert werden soll, andernfalls false. Da diese Einstellung die Leistung beeinflusst, sollten Sie das Attribut nur während der Entwicklung auf true festlegen.Description
Stellt eine Textbeschreibung des Handlers bereit. Dieser Wert wird vom ASP.NET-Parser ignoriert.Language
Gibt die Sprache zum Kompilieren des Codes im Handler an. Der Wert kann jede .NET Framework-Sprache enthalten, darunter Visual Basic, C# und JScript. Es kann nur eine Sprache pro Handler verwendet werden.WarningLevel
Gibt die Warnstufe an, ab der der Compiler Warnungen als Fehler behandeln und die Kompilierung des Handlers anhalten soll. Mögliche Warnstufen sind 0 bis 4. Weitere Informationen finden Sie unter der WarningLevel-Eigenschaft.
Hinweise
Diese Direktive ist nur in Dateien gültig, die als HTTP-Handler verwendet werden. Standardmäßig behandelt ASP.NET Dateien mit der Dateinamenerweiterung .ashx als Handler.
Tipp
Wenn Sie für die Handler nicht die Dateinamenerweiterung .ashx verwenden möchten, können Sie einen Handler als Standardklasse (eine CS- oder VB-Datei) erstellen, die die IHttpHandler-Schnittstelle implementiert. Für eine Handlerklassendatei ist die @ WebHandler-Direktive nicht erforderlich. Anschließend müssen Sie die bevorzugte Dateinamenerweiterung mit ASP.NET registrieren. Ausführliche Informationen finden Sie unter Gewusst wie: Registrieren von HTTP-Handlern.
Sie können nur eine @ WebHandler-Direktive pro Datei verwenden. Außerdem können Sie nur ein Language-Attribut pro @ WebHandler-Direktive definieren, da pro Handler nur eine Sprache verwendet werden darf.
Tipp
Die @ WebHandler-Direktive hat eine Reihe von Attributen mit anderen Direktiven gemeinsam, die sich auf eine gesamte Quelldatei beziehen, z. B. die @ Page-Direktive, die in ASPX-Dateien für Webseiten verwendet wird.
Wenn Sie mehrere Attribute für die @ WebHandler-Direktive definieren möchten, trennen Sie jedes Attribut-Wert-Paar durch ein einzelnes Leerzeichen. Fügen Sie vor und hinter dem Gleichheitszeichen (=), das das Attribut mit seinem Wert verbindet, keine Leerzeichen ein.
Beispiel
Das folgende Codebeispiel weist den ASP.NET-Seitencompiler an, Visual Basic als Inlinecodesprache zu verwenden, und legt einen Klassennamen fest.
<%@ WebHandler Language="VB" Class="MyTestHandler" %>
Siehe auch
Konzepte
Übersicht über HTTP-Handler und HTTP-Module