UrlRoutingHandler Classe

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Serve como classe base para classes que permitem personalizar como o roteamento do ASP.NET processa uma solicitação.

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

Herança

Object

UrlRoutingHandler

Implementações

IHttpHandler

Comentários

Você pode personalizar como ASP.NET roteamento lida com solicitações mapeando uma extensão de nome de arquivo para um manipulador de roteamento específico em vez de usando a UrlRoutingModule classe como o manipulador de roteamento para cada solicitação.

Para personalizar como ASP.NET roteamento lida com uma solicitação de uma URL com uma extensão de nome de arquivo específica, você cria uma classe derivada da UrlRoutingHandler classe . Por exemplo, você pode criar um manipulador de roteamento personalizado que processa solicitações para um arquivo que tem a extensão .abc.

Para registrar um manipulador personalizado para uma extensão de nome de arquivo específica, você deve adicionar esse manipulador no arquivo Web.config. O exemplo a seguir mostra como registrar um manipulador personalizado para um site ASP.NET que está em execução no IIS 6.0 ou IIS 7.0 no modo Clássico.

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

O exemplo a seguir mostra como registrar o mesmo manipulador para um site do ASP.NET em execução no IIS 7.0.

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

Construtores

UrlRoutingHandler()

Inicializa uma nova instância da classe UrlRoutingHandler.

Propriedades

IsReusable	Obtém um valor que indica se outra solicitação pode utilizar a instância de UrlRoutingHandler.
RouteCollection	Obtém ou define a coleção de rotas definidas para o aplicativo ASP.NET.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ProcessRequest(HttpContext)	Processa uma solicitação HTTP que corresponde a uma rota.
ProcessRequest(HttpContextBase)	Processa uma solicitação HTTP que corresponde a uma rota.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAndProcessRequest(IHttpHandler, HttpContextBase)	Quando substituído em uma classe derivada, valida o manipulador HTTP e executa as etapas necessárias para processar a solicitação.

Implantações explícitas de interface

IHttpHandler.IsReusable	Obtém um valor que indica se outra solicitação pode utilizar a instância de UrlRoutingHandler.
IHttpHandler.ProcessRequest(HttpContext)	Processa uma solicitação HTTP que corresponde a uma rota.

Confira também

• Roteamento do ASP.NET