Versión imprimible       Enviar     
Evaluar y enviar comentarios

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
DefaultHttpHandler (Clase)
Representa las propiedades y los métodos de un controlador HTTP predeterminado.

Espacio de nombres: System.Web
Ensamblado: System.Web (en system.web.dll)

Visual Basic (Declaración)
Public Class DefaultHttpHandler
    Implements IHttpAsyncHandler, IHttpHandler
Visual Basic (Uso)
Dim instance As DefaultHttpHandler
C#
public class DefaultHttpHandler : IHttpAsyncHandler, IHttpHandler
C++
public ref class DefaultHttpHandler : IHttpAsyncHandler, IHttpHandler
J#
public class DefaultHttpHandler implements IHttpAsyncHandler, IHttpHandler
JScript
public class DefaultHttpHandler implements IHttpAsyncHandler, IHttpHandler
XAML
No aplicable.

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:

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.

Visual Basic
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
C#
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);
        }
    }

}
System.Object
  System.Web.DefaultHttpHandler
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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

Compatible con: 3.0, 2.0
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker