<add>-Element für <httpHandlers>

Artikel
03/31/2008

Fügt einer Anwendung einen Handler hinzu. Ein Handler ist eine IHttpHandler- oder eine IHttpHandlerFactory-Klasse, die Anforderungen bestimmter URLs verarbeitet.

<configuration>
   <system.web>
      <httpHandlers>
         <add>

<add verb="verb list"      path="path/wildcard"      type="type,assemblyname"     validate="true|false"/>

Erforderliche Attribute

Attribut	Beschreibung
verb	Die verb-Liste kann entweder eine durch Kommas getrennte Liste von HTTP-Verben sein (z. B. "GET, PUT, POST") oder eine Startskriptzuordnung (z. B. das Platzhalterzeichen * [Sternchen]).
path	Das path-Attribut kann entweder einen einzelnen URL-Pfad oder eine einfache Platzhalterzeichenfolge (z. B. *.aspx) enthalten.
type	Gibt eine durch Kommas getrennte Klassen-/Assemblykombination an. ASP.NET sucht nach der Assembly-DLL zunächst im privaten \bin-Verzeichnis der Anwendung und anschließend im Assemblycache des Systems.

Optionales Attribut

Attribut	Beschreibung
validate	Wenn validate nicht auf false festgelegt ist, lädt ASP.NET diese Klasse erst bei Eingang der tatsächlich übereinstimmenden Anforderung. Dadurch wird der Fehler zwar potenziell verzögert, die Startzeit jedoch verbessert.

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.

Für Microsoft Internet-Informationsdienste (IIS) gilt ein eigenes Konzept für die Zuordnung von Erweiterungen zu ISAPIs. 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 Dateien als ASPX-, ASMX-, ASAX-Dateien usw.) müssen Sie 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.HttpHandlersSectionHandler

Siehe auch

<httpHandlers>-Element | ASP.NET-Konfiguration | ASP.NET-Einstellungsschema

Freigeben über