DefaultHttpHandler Classe

Définition

Représente les propriétés et les méthodes d'un gestionnaire HTTP par défaut.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
Héritage
DefaultHttpHandler
Implémente

Exemples

L’exemple de code suivant montre comment implémenter un gestionnaire HTTP personnalisé en dérivant de la DefaultHttpHandler classe.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

Remarques

Un DefaultHttpHandler objet intercepte les demandes entrantes dans le pipeline http lorsque l’interception des demandes a été configurée par le biais de Internet Information Services (IIS) 6,0 et qu’aucune liaison explicite ne s’applique à l’extension demandée.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.

L’interception des requêtes peut être configurée à l’aide de la fonctionnalité de mappage d’application générique introduite dans IIS 6,0.Request interception can be set up through the wildcard application mapping feature introduced in IIS 6.0. Pour plus d’informations, consultez MSDN Library pour plus d’informations sur l’utilisation des mappages d’applications génériques pour remapper une URL.For more information, search the MSDN Library for information about using wildcard application maps to remap a URL.

La DefaultHttpHandler classe implémente l' IHttpAsyncHandler interface pour fournir un traitement de requête asynchrone.The DefaultHttpHandler class implements the IHttpAsyncHandler interface to provide asynchronous request processing. Pour obtenir des informations générales sur les gestionnaires HTTP, consultez la rubrique vue d’ensemble des gestionnaires http et des modules http.For general information about HTTP handlers, see HTTP Handlers and HTTP Modules Overview. En outre, pour plus d’informations, consultez les rubriques suivantes:Additionally, for more information see the following:

Les classes peuvent dériver DefaultHttpHandler de la classe pour fournir une gestion personnalisée des requêtes.Classes can derive from the DefaultHttpHandler class to provide customized handling of requests. Un gestionnaire HTTP asynchrone dérivé de DefaultHttpHandler peut substituer la méthode pour modifier le BeginProcessRequest mode de traitement des demandes.An asynchronous HTTP handler that is derived from the DefaultHttpHandler could override the BeginProcessRequest method to change how requests are processed.

N' DefaultHttpHandler utilise pas d’erreurs ASP.net.A DefaultHttpHandler does not use ASP.NET errors. Le contenu existant qui utilise des erreurs IIS ou un mécanisme d’erreur personnalisé ISAPI des fonctionnerait sans modification.Existing content that uses IIS errors or a propriety ISAPI custom error mechanism would work unchanged.

Constructeurs

DefaultHttpHandler()

Initialise une nouvelle instance de la classe DefaultHttpHandler.Initializes a new instance of the DefaultHttpHandler class.

Propriétés

Context

Obtient le contexte associé à l'objet DefaultHttpHandler actuel.Gets the context that is associated with the current DefaultHttpHandler object.

ExecuteUrlHeaders

Obtient qu'une collection d'en-têtes de demande et de valeurs de demande à transférer avec la demande.Gets a collection of request headers and request values to transfer along with the request.

IsReusable

Obtient une valeur Boolean indiquant qu'une autre demande peut utiliser l'instance actuelle de la classe DefaultHttpHandler.Gets a Boolean value indicating that another request can use the current instance of the DefaultHttpHandler class.

Méthodes

BeginProcessRequest(HttpContext, AsyncCallback, Object)

Lance un appel asynchrone au gestionnaire HTTP.Initiates an asynchronous call to the HTTP handler.

EndProcessRequest(IAsyncResult)

Fournit une méthode End pour un processus asynchrone.Provides an end method for an asynchronous process.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnExecuteUrlPreconditionFailure()

Appelé lorsque les conditions préalables empêchent l'objet DefaultHttpHandler de traiter une demande.Called when preconditions prevent the DefaultHttpHandler object from processing a request.

OverrideExecuteUrlPath()

Substitue l'URL cible de la demande actuelle.Overrides the target URL for the current request.

ProcessRequest(HttpContext)

Active un objet DefaultHttpHandler pour traiter des demandes Web HTTP.Enables a DefaultHttpHandler object to process of HTTP Web requests.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi