DefaultHttpHandler DefaultHttpHandler DefaultHttpHandler DefaultHttpHandler Class

Definition

Stellt die Eigenschaften und Methoden eines HTTP-Standardhandlers dar.Represents the properties and methods of a default 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
Vererbung
DefaultHttpHandlerDefaultHttpHandlerDefaultHttpHandlerDefaultHttpHandler
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein angepasster HTTP-Handler durch DefaultHttpHandler ableiten von der-Klasse implementiert wird.The following code example demonstrates how to implement a customized HTTP handler by deriving from the DefaultHttpHandler class.

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

Hinweise

Ein DefaultHttpHandler -Objekt fängt eingehende Anforderungen in der HTTP-Pipeline ab, wenn die Anforderungs Abfang Funktion über Internetinformationsdienste (IIS) 6,0 konfiguriert wurde und keine expliziten Bindungen auf die angeforderte Erweiterung angewendet wurden.A DefaultHttpHandler object intercepts incoming requests in the HTTP pipeline when both request interception has been configured through Internet Information Services (IIS) 6.0 and no explicit bindings apply to the requested extension.

Das Abfangen von Anforderungen kann über das in IIS 6,0 eingeführte Feature "Platzhalter Anwendungs Zuordnung" eingerichtet werden.Request interception can be set up through the wildcard application mapping feature introduced in IIS 6.0. Weitere Informationen finden Sie in der MSDN Library unter Verwenden von Platzhalter-Anwendungs Zuordnungen zum erneuten Zuordnen einer URL.For more information, search the MSDN Library for information about using wildcard application maps to remap a URL.

Die DefaultHttpHandler -Klasse implementiert IHttpAsyncHandler die-Schnittstelle, um die asynchrone Anforderungs Verarbeitung bereitzustellen.The DefaultHttpHandler class implements the IHttpAsyncHandler interface to provide asynchronous request processing. Allgemeine Informationen zu HTTP-Handlern finden Sie unter Übersicht über HTTP-Handler und HTTP-Module.For general information about HTTP handlers, see HTTP Handlers and HTTP Modules Overview. Weitere Informationen finden Sie in den folgenden Bereichen:Additionally, for more information see the following:

Klassen können von der- DefaultHttpHandler Klasse abgeleitet werden, um die angepasste Verarbeitung von Anforderungen bereitzustellen.Classes can derive from the DefaultHttpHandler class to provide customized handling of requests. Ein asynchroner HTTP-Handler, der DefaultHttpHandler von abgeleitet ist, kann die BeginProcessRequest -Methode überschreiben, um zu ändern, wie Anforderungen verarbeitet werden.An asynchronous HTTP handler that is derived from the DefaultHttpHandler could override the BeginProcessRequest method to change how requests are processed.

Ein DefaultHttpHandler verwendet keine ASP.NET-Fehler.A DefaultHttpHandler does not use ASP.NET errors. Vorhandener Inhalt, der IIS-Fehler oder einen benutzerdefinierten ISAPI-Fehler Mechanismus verwendet, würde unverändert funktionieren.Existing content that uses IIS errors or a propriety ISAPI custom error mechanism would work unchanged.

Konstruktoren

DefaultHttpHandler() DefaultHttpHandler() DefaultHttpHandler() DefaultHttpHandler()

Initialisiert eine neue Instanz der DefaultHttpHandler-Klasse.Initializes a new instance of the DefaultHttpHandler class.

Eigenschaften

Context Context Context Context

Ruft den Kontext ab, der dem aktuellen DefaultHttpHandler-Objekt zugeordnet ist.Gets the context that is associated with the current DefaultHttpHandler object.

ExecuteUrlHeaders ExecuteUrlHeaders ExecuteUrlHeaders ExecuteUrlHeaders

Ruft eine Auflistung der Anforderungsheader und Anforderungswerte ab, die mit der Anforderung übertragen werden.Gets a collection of request headers and request values to transfer along with the request.

IsReusable IsReusable IsReusable IsReusable

Ruft einen booleschen Wert ab, der angibt, dass eine andere Anforderung die aktuelle Instanz der DefaultHttpHandler-Klasse verwenden kann.Gets a Boolean value indicating that another request can use the current instance of the DefaultHttpHandler class.

Methoden

BeginProcessRequest(HttpContext, AsyncCallback, Object) BeginProcessRequest(HttpContext, AsyncCallback, Object) BeginProcessRequest(HttpContext, AsyncCallback, Object) BeginProcessRequest(HttpContext, AsyncCallback, Object)

Initialisiert einen asynchronen Aufruf des HTTP-Handlers.Initiates an asynchronous call to the HTTP handler.

EndProcessRequest(IAsyncResult) EndProcessRequest(IAsyncResult) EndProcessRequest(IAsyncResult) EndProcessRequest(IAsyncResult)

Stellt eine Methode zum Beenden für einen asynchronen Prozess bereit.Provides an end method for an asynchronous process.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnExecuteUrlPreconditionFailure() OnExecuteUrlPreconditionFailure() OnExecuteUrlPreconditionFailure() OnExecuteUrlPreconditionFailure()

Wird aufgerufen, wenn aufgrund von Vorbedingungen das DefaultHttpHandler-Objekt eine Anforderung nicht verarbeitet.Called when preconditions prevent the DefaultHttpHandler object from processing a request.

OverrideExecuteUrlPath() OverrideExecuteUrlPath() OverrideExecuteUrlPath() OverrideExecuteUrlPath()

Überschreibt die Ziel-URL für die aktuelle Anforderung.Overrides the target URL for the current request.

ProcessRequest(HttpContext) ProcessRequest(HttpContext) ProcessRequest(HttpContext) ProcessRequest(HttpContext)

Aktiviert zum Verarbeiten der HTTP-Webanforderungen ein DefaultHttpHandler-Objekt.Enables a DefaultHttpHandler object to process of HTTP Web requests.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch