DefaultHttpHandler Classe

Definição

Representa as propriedades e métodos de um manipulador HTTP padrão.

public class DefaultHttpHandler : System.Web.IHttpAsyncHandler
Herança
DefaultHttpHandler
Implementações

Exemplos

O exemplo de código a seguir demonstra como implementar um manipulador HTTP personalizado derivando da DefaultHttpHandler classe .

public class AsyncDefaultHttpHandler : DefaultHttpHandler
{
    private HttpContext _context;

    public override IAsyncResult BeginProcessRequest(
      HttpContext context, AsyncCallback callback, object state)
    {
        AsyncResultSample ar = new AsyncResultSample(callback, state);
        _context = context;

        return ar;
    }

    public override void EndProcessRequest(IAsyncResult result)
    {
        _context.Response.Write("EndProcessRequest called.");
    }

    // This method should not be called asynchronously.
    public override void ProcessRequest(HttpContext context)
    {
        throw new InvalidOperationException(
                  "Asynchronous processing failed.");
    }

    // Enables pooling when set to true
    public override bool IsReusable
    {
        get { return true; }
    }
}

// Tracks state between the begin and end calls.
class AsyncResultSample : IAsyncResult
{
    private AsyncCallback callback = null;
    private Object asyncState;
    private Boolean isCompleted;

    internal AsyncResultSample(AsyncCallback cb, Object state)
    {
        this.callback = cb;
        asyncState = state;
        isCompleted = false;
    }

    public object AsyncState
    {
        get
        {
            return asyncState;
        }
    }

    public bool CompletedSynchronously
    {
        get
        {
            return false;
        }
    }

    public WaitHandle AsyncWaitHandle
    {
        get
        {
            throw new InvalidOperationException(
                      "ASP.NET should not use this property .");
        }
    }

    public bool IsCompleted
    {
        get
        {
            return isCompleted;
        }
    }

    internal void SetCompleted()
    {
        isCompleted = true;
        if (callback != null)
        {
            callback(this);
        }
    }
}

Comentários

Um DefaultHttpHandler objeto intercepta solicitações de entrada no pipeline HTTP quando ambas as interceptações de solicitação foram configuradas por meio do IIS (Serviços de Informações da Internet) 6.0 e nenhuma associação explícita se aplica à extensão solicitada.

A interceptação de solicitação pode ser configurada por meio do recurso de mapeamento de aplicativo curinga introduzido no IIS 6.0.

A DefaultHttpHandler classe implementa a IHttpAsyncHandler interface para fornecer processamento de solicitação assíncrona. Para obter informações gerais sobre manipuladores HTTP, consulte Visão geral de manipuladores HTTP e módulos HTTP. Além disso, para obter mais informações, confira o seguinte:

As classes podem derivar da DefaultHttpHandler classe para fornecer tratamento personalizado de solicitações. Um manipulador HTTP assíncrono derivado do DefaultHttpHandler pode substituir o BeginProcessRequest método para alterar como as solicitações são processadas.

Um DefaultHttpHandler não usa erros de ASP.NET. O conteúdo existente que usa erros do IIS ou um mecanismo de erro personalizado ISAPI proprietário funcionaria inalterado.

Construtores

DefaultHttpHandler()

Inicializa uma nova instância da classe DefaultHttpHandler.

Propriedades

Context

Obtém o contexto que está associado ao objeto DefaultHttpHandler atual.

ExecuteUrlHeaders

Obtém uma coleção de cabeçalhos de solicitação e valores de solicitação para transferir junto com a solicitação.

IsReusable

Obtém um valor booliano que indica se outra solicitação pode usar a instância atual da classe DefaultHttpHandler.

Métodos

BeginProcessRequest(HttpContext, AsyncCallback, Object)

Inicia uma chamada assíncrona para o manipulador HTTP.

EndProcessRequest(IAsyncResult)

Fornece um método final para um processo assíncrono.

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)
OnExecuteUrlPreconditionFailure()

Chamado quando as pré-condições impedem que o objeto DefaultHttpHandler processe uma solicitação.

OverrideExecuteUrlPath()

Substitui a URL de destino para a solicitação atual.

ProcessRequest(HttpContext)

Permite que um objeto DefaultHttpHandler processe solicitações da Web HTTP.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também