DefaultHttpHandler Sınıf

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Varsayılan HTTP işleyicisinin özelliklerini ve yöntemlerini temsil eder.

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

Devralma

Object

DefaultHttpHandler

Uygulamalar

IHttpAsyncHandler IHttpHandler

Örnekler

Aşağıdaki kod örneğinde, sınıfından türetilerek özelleştirilmiş bir HTTP işleyicisinin nasıl uygulandığı gösterilmektedir DefaultHttpHandler .

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

Açıklamalar

Her DefaultHttpHandler iki istek kesme işlemi de Internet Information Services (IIS) 6.0 aracılığıyla yapılandırıldığında ve istenen uzantıya açık bağlama uygulanmadığında, nesne HTTP işlem hattında gelen istekleri durdurur.

İstek kesme, IIS 6.0'da kullanıma sunulan joker karakter uygulama eşleme özelliği aracılığıyla ayarlanabilir.

DefaultHttpHandler sınıfı, zaman uyumsuz istek işleme sağlamak için arabirimini uygularIHttpAsyncHandler. HTTP işleyicileri hakkında genel bilgi için bkz. HTTP İşleyicileri ve HTTP Modüllerine Genel Bakış. Ayrıca, daha fazla bilgi için aşağıdakilere bakın:

• Zaman uyumsuz HTTP işleyicileri oluşturma hakkında bkz . İzlenecek yol: Zaman Uyumsuz HTTP İşleyicisi Oluşturma.

• HTTP işleyicilerini kaydetme hakkında bkz . Nasıl yapılır: HTTP İşleyicilerini Kaydetme.

Sınıflar, isteklerin DefaultHttpHandler özelleştirilmiş işlenmesini sağlamak için sınıfından türetilebilir. 'den DefaultHttpHandler türetilen zaman uyumsuz http işleyicisi, isteklerin BeginProcessRequest işlenme biçimini değiştirmek için yöntemini geçersiz kılabilir.

A DefaultHttpHandler , ASP.NET hataları kullanmaz. IIS hataları veya bir özel ISAPI özel hata mekanizması kullanan mevcut içerik değişmeden çalışır.

Oluşturucular

DefaultHttpHandler()

DefaultHttpHandler sınıfının yeni bir örneğini başlatır.

Özellikler

Context	Geçerli DefaultHttpHandler nesneyle ilişkili bağlamı alır.
ExecuteUrlHeaders	İstek üst bilgileri ve istek değerleri koleksiyonu alır ve istekle birlikte aktarılır.
IsReusable	Başka bir isteğin sınıfın geçerli örneğini DefaultHttpHandler kullanabileceğini belirten bir Boole değeri alır.

Yöntemler

BeginProcessRequest(HttpContext, AsyncCallback, Object)	HTTP işleyicisine zaman uyumsuz bir çağrı başlatır.
EndProcessRequest(IAsyncResult)	Zaman uyumsuz bir işlem için bir bitiş yöntemi sağlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnExecuteUrlPreconditionFailure()	Önkoşullar nesnenin bir isteği işlemesini DefaultHttpHandler engellediğinde çağrılır.
OverrideExecuteUrlPath()	Geçerli isteğin hedef URL'sini geçersiz kılar.
ProcessRequest(HttpContext)	Bir DefaultHttpHandler nesnenin HTTP Web isteklerini işlemesini sağlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Nasıl yapılır: HTTP İşleyicilerini Kaydetme
• Nasıl yapılır: Zaman Uyumsuz HTTP İşleyicisi Oluşturma