DefaultHttpHandler Klas

Definitie

Naamruimte:

System.Web

Assembly:

System.Web.dll

Vertegenwoordigt de eigenschappen en methoden van een standaard HTTP-handler.

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

Overname

Object

DefaultHttpHandler

Implementeringen

IHttpAsyncHandler IHttpHandler

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een aangepaste HTTP-handler implementeert door deze te afleiden van de DefaultHttpHandler klasse.

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

Opmerkingen

Een DefaultHttpHandler-object onderschept binnenkomende aanvragen in de HTTP-pijplijn wanneer beide aanvraagonderschepping is geconfigureerd via Internet Information Services (IIS) 6.0 en er zijn geen expliciete bindingen van toepassing op de aangevraagde extensie.

Het onderscheppen van aanvragen kan worden ingesteld via de functie voor toepassingstoewijzing met jokertekens die is geïntroduceerd in IIS 6.0.

De DefaultHttpHandler klasse implementeert de IHttpAsyncHandler interface om asynchrone aanvraagverwerking te bieden. Zie het overzicht van HTTP-handlers en HTTP-modules voor algemene informatie over HTTP-handlers. Zie ook het volgende voor meer informatie:

• Zie Walkthrough voor het maken van asynchrone HTTP-handlers: Een Asynchrone HTTP-handler maken.

• Informatie over het registreren van HTTP-handlers: HTTP-handlers registreren.

Klassen kunnen worden afgeleid van de DefaultHttpHandler klasse om aangepaste verwerking van aanvragen te bieden. Een asynchrone HTTP-handler die is afgeleid van de DefaultHttpHandler kan de BeginProcessRequest methode overschrijven om te wijzigen hoe aanvragen worden verwerkt.

Een DefaultHttpHandler maakt geen gebruik van ASP.NET fouten. Bestaande inhoud die gebruikmaakt van IIS-fouten of een aangepast ISAPI-foutmechanisme voor propriety werkt ongewijzigd.

Constructors

Name	Description
DefaultHttpHandler()	Initialiseert een nieuw exemplaar van de DefaultHttpHandler klasse.

Eigenschappen

Name	Description
Context	Hiermee haalt u de context op die is gekoppeld aan het huidige DefaultHttpHandler object.
ExecuteUrlHeaders	Hiermee haalt u een verzameling aanvraagheaders en aanvraagwaarden op die samen met de aanvraag moeten worden overgedragen.
IsReusable	Hiermee wordt een Booleaanse waarde opgehaald die aangeeft dat een andere aanvraag het huidige exemplaar van de DefaultHttpHandler klasse kan gebruiken.

Methoden

Name	Description
BeginProcessRequest(HttpContext, AsyncCallback, Object)	Start een asynchrone aanroep naar de HTTP-handler.
EndProcessRequest(IAsyncResult)	Biedt een eindmethode voor een asynchroon proces.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnExecuteUrlPreconditionFailure()	Aangeroepen wanneer voorwaarden verhinderen dat het DefaultHttpHandler object een aanvraag verwerkt.
OverrideExecuteUrlPath()	Hiermee wordt de doel-URL voor de huidige aanvraag overschreven.
ProcessRequest(HttpContext)	Hiermee kan een DefaultHttpHandler object HTTP-webaanvragen verwerken.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Zie ook

• Procedure: HTTP-handlers registreren
• Procedure: Een Asynchrone HTTP-handler maken