UrlRoutingHandler Klasse

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Dient als Basisklasse für Klassen, mit denen Sie anpassen können, wie ASP.NET Routing eine Anforderung verarbeitet.

public ref class UrlRoutingHandler abstract : System::Web::IHttpHandler

public abstract class UrlRoutingHandler : System.Web.IHttpHandler

type UrlRoutingHandler = class
    interface IHttpHandler

Public MustInherit Class UrlRoutingHandler
Implements IHttpHandler

Vererbung

Object

UrlRoutingHandler

Implementiert

IHttpHandler

Hinweise

Sie können anpassen, wie ASP.NET Routing Anforderungen verarbeitet, indem Sie eine Dateinamenerweiterung einem bestimmten Routinghandler zuordnen, anstatt die klasse UrlRoutingModule als Routinghandler für jede Anforderung zu verwenden.

Um anzupassen, wie ASP.NET Routing eine Anforderung für eine URL mit einer bestimmten Dateinamenerweiterung verarbeitet, erstellen Sie eine Klasse, die von der klasse UrlRoutingHandler abgeleitet wird. Sie können z. B. einen benutzerdefinierten Routinghandler erstellen, der Anforderungen für eine Datei verarbeitet, die über die Erweiterung .abcverfügt.

Um einen benutzerdefinierten Handler für eine bestimmte Dateinamenerweiterung zu registrieren, müssen Sie diesen Handler in der Web.config-Datei hinzufügen. Das folgende Beispiel zeigt, wie Sie einen benutzerdefinierten Handler für eine ASP.NET-Website registrieren, die in IIS 6.0 oder IIS 7.0 im klassischen Modus ausgeführt wird.

<system.web>
  <httpHandlers>
    <add verb="*" path="*.abc"
        type="Contoso.Routing.CustomRoutingHandler" />
  </httpHandlers>
</system.web>

Das folgende Beispiel zeigt, wie Sie den gleichen Handler für eine ASP.NET-Website registrieren, die in IIS 7.0 ausgeführt wird.

<system.webServer>
  <handlers>
    <add verb="*" path="*.abc"
        type="Contoso.Routing.CustomRoutingHandler"
        resourceType="Unspecified" />
  </handlers>
</system.webServer>

Konstruktoren

Name	Beschreibung
UrlRoutingHandler()	Initialisiert eine neue Instanz der UrlRoutingHandler-Klasse.

Eigenschaften

Name	Beschreibung
IsReusable	Ruft einen Wert ab, der angibt, ob eine andere Anforderung die UrlRoutingHandler Instanz verwenden kann.
RouteCollection	Dient zum Abrufen oder Festlegen der Auflistung der definierten Routen für die ASP.NET Anwendung.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ProcessRequest(HttpContext)	Verarbeitet eine HTTP-Anforderung, die einer Route entspricht.
ProcessRequest(HttpContextBase)	Verarbeitet eine HTTP-Anforderung, die einer Route entspricht.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAndProcessRequest(IHttpHandler, HttpContextBase)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, überprüft der HTTP-Handler und führt die Schritte aus, die zum Verarbeiten der Anforderung erforderlich sind.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IHttpHandler.IsReusable	Ruft einen Wert ab, der angibt, ob eine andere Anforderung die UrlRoutingHandler Instanz verwenden kann.
IHttpHandler.ProcessRequest(HttpContext)	Verarbeitet eine HTTP-Anforderung, die einer Route entspricht.

Weitere Informationen

• ASP.NET Routing