DefaultHttpHandler Třída

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Představuje vlastnosti a metody výchozí obslužné rutiny HTTP.

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

Dědičnost

Object

DefaultHttpHandler

Implementuje

IHttpAsyncHandler IHttpHandler

Příklady

Následující příklad kódu ukazuje, jak implementovat přizpůsobenou obslužnou rutinu HTTP odvozením z DefaultHttpHandler třídy.

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

Poznámky

Objekt DefaultHttpHandler zachycuje příchozí požadavky v kanálu HTTP, pokud bylo nakonfigurováno zachycení obou požadavků prostřednictvím Internetové Informační Služby (IIS) 6.0 a na požadované rozšíření se nevztahují žádné explicitní vazby.

Zachycování požadavků je možné nastavit prostřednictvím funkce mapování aplikace se zástupným znakem zavedeným ve službě IIS 6.0.

Třída DefaultHttpHandler implementuje IHttpAsyncHandler rozhraní pro poskytování asynchronního zpracování požadavků. Obecné informace o obslužných rutinách HTTP najdete v tématu Přehled obslužných rutin HTTP a modulů HTTP. Další informace najdete v následujících tématech:

• Informace o vytváření asynchronních obslužných rutin HTTP naleznete v tématu Návod: Vytvoření asynchronní obslužné rutiny HTTP.

• Informace o registraci obslužných rutin HTTP naleznete v tématu Postupy: Registrace obslužných rutin HTTP.

Třídy mohou odvozovat z DefaultHttpHandler třídy, aby poskytovaly přizpůsobené zpracování požadavků. Asynchronní obslužná rutina HTTP odvozená od metody DefaultHttpHandler může přepsat metodu BeginProcessRequest , aby se změnil způsob zpracování požadavků.

DefaultHttpHandler nepoužívá chyby ASP.NET. Stávající obsah, který používá chyby služby IIS nebo vlastní mechanismus chyb ISAPI propriety, by fungoval beze změny.

Konstruktory

Name	Description
DefaultHttpHandler()	Inicializuje novou instanci DefaultHttpHandler třídy.

Vlastnosti

Name	Description
Context	Získá kontext, který je přidružen k aktuálnímu DefaultHttpHandler objektu.
ExecuteUrlHeaders	Získá kolekci hlaviček požadavků a hodnot požadavků pro přenos spolu s požadavkem.
IsReusable	Získá logickou hodnotu označující, že jiný požadavek může použít aktuální instanci DefaultHttpHandler třídy.

Metody

Name	Description
BeginProcessRequest(HttpContext, AsyncCallback, Object)	Inicializuje asynchronní volání obslužné rutiny HTTP.
EndProcessRequest(IAsyncResult)	Poskytuje koncovou metodu asynchronního procesu.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnExecuteUrlPreconditionFailure()	Volá se, když předpoklady brání objektu DefaultHttpHandler ve zpracování požadavku.
OverrideExecuteUrlPath()	Přepíše cílovou adresu URL aktuálního požadavku.
ProcessRequest(HttpContext)	DefaultHttpHandler Umožňuje objekt zpracovávat webové požadavky HTTP.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Postupy: Registrace obslužných rutin HTTP
• Postupy: Vytvoření asynchronní obslužné rutiny HTTP