DefaultHttpHandler Classe

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Représente les propriétés et méthodes d’un gestionnaire HTTP par défaut.

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

Object

DefaultHttpHandler

Implémente

IHttpAsyncHandler IHttpHandler

Exemples

L’exemple de code suivant montre comment implémenter un gestionnaire HTTP personnalisé en dérivant de la DefaultHttpHandler classe.

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 objet DefaultHttpHandler intercepte les requêtes entrantes dans le pipeline HTTP lorsque les deux interceptions de requête ont été configurées via Internet Information Services (IIS) 6.0 et qu’aucune liaison explicite ne s’applique à l’extension demandée.

L’interception des demandes peut être configurée via la fonctionnalité de mappage d’application générique introduite dans IIS 6.0.

La DefaultHttpHandler classe implémente l’interface pour fournir un IHttpAsyncHandler traitement de demande asynchrone. Pour obtenir des informations générales sur les gestionnaires HTTP, consultez La vue d’ensemble des gestionnaires HTTP et des modules HTTP. En outre, pour plus d’informations, consultez les rubriques suivantes :

• À propos de la création de gestionnaires HTTP asynchrones, consultez Procédure pas à pas : création d’un gestionnaire HTTP asynchrone.

• À propos de l’inscription de gestionnaires HTTP, consultez Guide pratique pour inscrire des gestionnaires HTTP.

Les classes peuvent dériver de la DefaultHttpHandler classe pour fournir une gestion personnalisée des requêtes. Un gestionnaire HTTP asynchrone dérivé de la DefaultHttpHandler méthode peut remplacer la méthode pour modifier la BeginProcessRequest façon dont les requêtes sont traitées.

Une DefaultHttpHandler n’utilise pas d’erreurs ASP.NET. Le contenu existant qui utilise des erreurs IIS ou un mécanisme d’erreur personnalisé ISAPI propriétaire fonctionne sans modification.

Constructeurs

Nom	Description
DefaultHttpHandler()	Initialise une nouvelle instance de la classe DefaultHttpHandler.

Propriétés

Nom	Description
Context	Obtient le contexte associé à l’objet actuel DefaultHttpHandler .
ExecuteUrlHeaders	Obtient une collection d’en-têtes de requête et de valeurs de requête à transférer avec la requête.
IsReusable	Obtient une valeur booléenne indiquant qu’une autre requête peut utiliser l’instance actuelle de la DefaultHttpHandler classe.

Méthodes

Nom	Description
BeginProcessRequest(HttpContext, AsyncCallback, Object)	Lance un appel asynchrone au gestionnaire HTTP.
EndProcessRequest(IAsyncResult)	Fournit une méthode de fin pour un processus asynchrone.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnExecuteUrlPreconditionFailure()	Appelée lorsque les conditions préalables empêchent l’objet DefaultHttpHandler de traiter une demande.
OverrideExecuteUrlPath()	Remplace l’URL cible de la requête actuelle.
ProcessRequest(HttpContext)	Permet à un DefaultHttpHandler objet de traiter des requêtes web HTTP.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Guide pratique pour inscrire des gestionnaires HTTP
• Guide pratique pour créer un gestionnaire HTTP asynchrone