DefaultHttpHandler Classe

Referência

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

public ref class DefaultHttpHandler : System::Web::IHttpAsyncHandler

public class DefaultHttpHandler : System.Web.IHttpAsyncHandler

type DefaultHttpHandler = class
    interface IHttpAsyncHandler
    interface IHttpHandler

Public Class DefaultHttpHandler
Implements IHttpAsyncHandler

Herança: Object
DefaultHttpHandler

Implementações: IHttpAsyncHandler IHttpHandler

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);
        }
    }
}

Public Class defaulthttpexampleVB
    Inherits DefaultHttpHandler

    Private _context As HttpContext

    Public Overrides Function BeginProcessRequest _
        (ByVal context As HttpContext, _
         ByVal callback As AsyncCallback, _
         ByVal state As Object) As IAsyncResult

        Dim ar As New AsyncResultSample(callback, state)
        _context = context

        Return (ar)
    End Function

    Public Overrides Sub EndProcessRequest(ByVal result As IAsyncResult)
        _context.Response.Write("EndProcessRequest called.")
    End Sub

    ' This method should not be called asynchronously.
    Public Overrides Sub ProcessRequest(ByVal context As HttpContext)
        Throw New InvalidOperationException _
          ("Asynchronous processing failed.")
    End Sub

    ' Enables pooling when set to true
    Public Overrides ReadOnly Property IsReusable() As Boolean
        Get
            Return True
        End Get
    End Property
End Class

' Tracks state between the begin and end calls.
Class AsyncResultSample
    Implements IAsyncResult
    Private callback As AsyncCallback = Nothing
    Private _asyncState As Object
    Private _isCompleted As Boolean

    Friend Sub New(ByVal cb As AsyncCallback, ByVal state As Object)
        Me.callback = cb
        _asyncState = state
        _isCompleted = False
    End Sub

    Public ReadOnly Property AsyncState() As Object _
      Implements IAsyncResult.AsyncState
        Get
            Return _asyncState
        End Get
    End Property

    Public ReadOnly Property CompletedSynchronously() _
      As Boolean Implements IAsyncResult.CompletedSynchronously
        Get
            Return False
        End Get
    End Property

    Public ReadOnly Property AsyncWaitHandle() _
      As WaitHandle Implements IAsyncResult.AsyncWaitHandle
        Get
            Throw New InvalidOperationException _
              ("ASP.NET should not use this property .")
        End Get
    End Property

    Public ReadOnly Property IsCompleted() _
      As Boolean Implements IAsyncResult.IsCompleted
        Get
            Return IsCompleted
        End Get
    End Property

    Friend Sub SetCompleted()
        _isCompleted = True
        If (callback <> Nothing) Then
            callback(Me)
        End If
    End Sub
End Class

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:

Sobre como criar manipuladores HTTP assíncronos, consulte Passo a passo: criando um manipulador HTTP assíncrono.
Sobre como registrar manipuladores HTTP, consulte Como registrar manipuladores HTTP.

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

Partilhar via