DefaultHttpHandler (Clase)

Un objeto DefaultHttpHandler intercepta las solicitudes de entrada en el conductor de HTTP cuando la interceptación de la solicitud se ha configurado a través de los Servicios de Microsoft Internet Information Server (IIS) versión 6.0 y no existe ningún enlace httpHandlers explícito que sea de aplicación a la extensión solicitada.

La interceptación de la solicitud se puede configurar mediante la característica de asignaciones de aplicación de comodines introducida en IIS 6.0. Para obtener más información, realice una búsqueda en MSDN Library, sobre el uso de asignaciones de aplicación de comodines para reasignar una dirección URL.

La clase DefaultHttpHandler implementa la interfaz IHttpAsyncHandler para proporcionar procesamiento asincrónico de solicitudes. Para obtener información general sobre los controladores HTTP, vea Procesamiento personalizado en ASP.NET con controladores HTTP. Además, para obtener más información:

• Para obtener información sobre cómo crear controladores HTTP asincrónicos, vea Cómo: Crear un controlador HTTP asincrónico.

• Sobre cómo registrar controladores HTTP, vea Cómo: Registrar controladores HTTP.

• Para obtener información sobre cómo desarrollar e implementar controladores HTTP asincrónicos y sincrónicos, vea Extender el procesamiento en ASP.NET con módulos HTTP.

Las clases se pueden derivar de la clase DefaultHttpHandler para proporcionar control personalizado de solicitudes. Un controlador HTTP asincrónico derivado de DefaultHttpHandler podría reemplazar el método BeginProcessRequest para cambiar la forma de procesar las solicitudes.

DefaultHttpHandler no utiliza los errores ASP.NET. El contenido existente que utiliza errores de IIS o un mecanismo de errores error personalizado de ISAPI de conveniencia funcionaría sin cambios.

El ejemplo de código siguiente muestra cómo implementar un controlador HTTP personalizado realizando una derivación de la clase DefaultHttpHandler.

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

}

• AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de la petición: LinkDemand; valor del permiso: Minimal
• AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de la petición: InheritanceDemand; valor del permiso: Minimal

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework