DefaultHttpHandler Kelas

Referensi

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili properti dan metode handler HTTP default.

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

Warisan: Object
DefaultHttpHandler

Penerapan: IHttpAsyncHandler IHttpHandler

Contoh

Contoh kode berikut menunjukkan cara mengimplementasikan handler HTTP yang disesuaikan dengan berasal dari DefaultHttpHandler kelas .

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

Keterangan

Objek DefaultHttpHandler mencegat permintaan masuk dalam alur HTTP ketika kedua intersepsi permintaan telah dikonfigurasi melalui Internet Information Services (IIS) 6.0 dan tidak ada pengikatan eksplisit yang berlaku untuk ekstensi yang diminta.

Intersepsi permintaan dapat disiapkan melalui fitur pemetaan aplikasi wildcard yang diperkenalkan di IIS 6.0.

Kelas DefaultHttpHandler mengimplementasikan IHttpAsyncHandler antarmuka untuk menyediakan pemrosesan permintaan asinkron. Untuk informasi umum tentang handler HTTP, lihat Penangan HTTP dan Gambaran Umum Modul HTTP. Selain itu, untuk informasi selengkapnya lihat yang berikut ini:

Tentang membuat handler HTTP asinkron, lihat Panduan: Membuat Handler HTTP Asinkron.
Tentang mendaftarkan handler HTTP, lihat Cara: Mendaftarkan Handler HTTP.

Kelas dapat berasal dari DefaultHttpHandler kelas untuk menyediakan penanganan permintaan yang disesuaikan. Handler HTTP asinkron yang berasal dari DefaultHttpHandler dapat mengambil alih BeginProcessRequest metode untuk mengubah cara permintaan diproses.

DefaultHttpHandler Tidak menggunakan kesalahan ASP.NET. Konten yang ada yang menggunakan kesalahan IIS atau mekanisme kesalahan kustom ISAPI yang eksklusif akan berfungsi tidak berubah.

Konstruktor

DefaultHttpHandler()

Menginisialisasi instans baru kelas DefaultHttpHandler.

Properti

Context	Mendapatkan konteks yang terkait dengan objek saat ini DefaultHttpHandler .
ExecuteUrlHeaders	Mendapatkan kumpulan header permintaan dan nilai permintaan untuk ditransfer bersama dengan permintaan.
IsReusable	Mendapatkan nilai Boolean yang menunjukkan bahwa permintaan lain dapat menggunakan instans DefaultHttpHandler kelas saat ini.

Metode

BeginProcessRequest(HttpContext, AsyncCallback, Object)	Memulai panggilan asinkron ke handler HTTP.
EndProcessRequest(IAsyncResult)	Menyediakan metode akhir untuk proses asinkron.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnExecuteUrlPreconditionFailure()	Dipanggil ketika prasyarat mencegah DefaultHttpHandler objek memproses permintaan.
OverrideExecuteUrlPath()	Mengambil alih URL target untuk permintaan saat ini.
ProcessRequest(HttpContext)	DefaultHttpHandler Mengaktifkan objek untuk memproses permintaan Web HTTP.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui