<httpHandlers>-Element
Ordnet eingehende Anforderungen in Abhängigkeit von dem in der Anforderung angegebenen URL und HTTP-Verb der entsprechenden IHttpHandler-Klasse oder IHttpHandlerFactory-Klasse zu.
<configuration>
<system.web>
<httpHandlers>
<httpHandlers>
<add verb="verb list" path="path/wildcard" type="type,assemblyname" validate="true|false"/> <remove verb="verb list" path="path/wildcard"/> <clear/></httpHandlers>
Untertags
| Untertag | Beschreibung |
|---|---|
| <add> | Gibt die verb/path-Zuordnung zu einer IHttpHandler- oder IHttpHandlerFactory-Klasse an. |
| <remove> | Entfernt eine verb/path-Zuordnung zu einer IHttpHandler-Klasse. Die <remove>-Direktive muss genau mit der verb/path-Kombination einer vorherigen <add>-Direktive übereinstimmen. Platzhalterzeichen werden nicht unterstützt. |
| <clear> | Entfernt alle IHttpHandler-Zuordnungen, die derzeit in der angegebenen Web.config-Datei konfiguriert sind oder von ihr geerbt wurden. |
Hinweise
Die <httpHandlers>-Einstellungen werden von den Unterverzeichnissen geerbt.
Die <add>-Direktiven werden der Reihenfolge nach von oben nach unten verarbeitet. Wenn in zwei oder mehr <add>-Unterelementen dieselbe verb-/path-Kombination angegeben wird, setzt das letzte <add> alle anderen außer Kraft.
Beachten Sie, dass bei den Microsoft Internet-Informationsdiensten (IIS) ein eigenes Konzept für die Zuordnung von Erweiterungen zu ISAPIs gilt. Damit die Einstellungen für eine gegebene Erweiterung in diesem Abschnitt wirksam werden, muss die Erweiterung in IIS der ASP.NET-ISAPI zugeordnet werden. Bei nicht standardmäßigen Erweiterungen (anderen Erweiterungen als .aspx, .asmx, .asax usw.) müssen die Benutzer IIS konfigurieren.
Beispiel
Im folgenden Beispiel werden alle HTTP-Anforderungen von Dateien mit der Dateinamenerweiterung .New der Klasse MyHandler.New zugeordnet, und HTTP-GET-Anforderungen und HTTP-HEAD-Anforderungen von Dateien mit der Dateinamenerweiterung .MyNewFileExtension werden der Klasse MyHandler.MNFEHandler zugeordnet. Beide Klassen befinden sich in der Assembly MyHandler, die sich wiederum in der Datei MyHandler.dll befindet.
<configuration>
<system.web>
<httpHandlers>
<add verb="*"
path="*.New"
type="MyHandler.New,MyHandler"/>
<add verb="GET,HEAD"
path="*.MyNewFileExtension"
type="MyHandler.MNFEHandler,MyHandler.dll"/>
</httpHandlers>
<system.web>
</configuration>
Anforderungen
Enthalten in: <system.web>
Webplattform: IIS 5.0, IIS 5.1, IIS 6.0
Konfigurationsdatei: Machine.config, Web.config
Konfigurationsabschnittshandler: System.Web.Configuration.HttpHandlersConfigHandler