HttpContext 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.

Merangkum semua informasi spesifik HTTP tentang permintaan HTTP individual.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Warisan: Object
HttpContext

Penerapan: IServiceProvider

Contoh

Contoh berikut menunjukkan cara mengakses dan menampilkan properti HttpContext objek. Konteks permintaan HTTP saat ini diakses dengan menggunakan Context properti Page objek .

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        // The HttpContext associated with the page can be accessed by the Context property.
        System.Text.StringBuilder sb = new System.Text.StringBuilder();
        // Use the current HttpContext object to determine if custom errors are enabled.
        sb.Append("Is custom errors enabled: " +
            Context.IsCustomErrorEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to determine if debugging is enabled.
        sb.Append("Is debugging enabled: " +
            Context.IsDebuggingEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to access the current TraceContext object.
        sb.Append("Trace Enabled: " +
            Context.Trace.IsEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to access the current HttpApplicationState object.
        sb.Append("Number of items in Application state: " +
            Context.Application.Count.ToString() + "<br/>");

        // Use the current HttpContext object to access the current HttpSessionState object.
        // Session state may not be configured.
        try
        {
            sb.Append("Number of items in Session state: " +
                Context.Session.Count.ToString() + "<br/>");
        }
        catch
        {
            sb.Append("Session state not enabled. <br/>");
        }

        // Use the current HttpContext object to access the current Cache object.
        sb.Append("Number of items in the cache: " +
            Context.Cache.Count.ToString() + "<br/>");

        // Use the current HttpContext object to determine the timestamp for the current HTTP Request.
        sb.Append("Timestamp for the HTTP request: " +
            Context.Timestamp.ToString() + "<br/>");

        // Assign StringBuilder object to output label.
        OutputLabel.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpContext Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       Using the current HttpContext to get information about the current page.
       <br />
       <asp:Label id="OutputLabel" runat="server"></asp:Label>           
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        ' The HttpContext associated with the page can be accessed by the Context property.
        Dim sb As New System.Text.StringBuilder()

        ' Use the current HttpContext object to determine if custom errors are enabled.
        sb.Append("Is custom errors enabled: " & _
            Context.IsCustomErrorEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to determine if debugging is enabled.
        sb.Append("Is debugging enabled: " & _
            Context.IsDebuggingEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current TraceContext object.
        sb.Append("Trace Enabled: " & _
            Context.Trace.IsEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current HttpApplicationState object.
        sb.Append("Number of items in Application state: " & _
            Context.Application.Count.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current HttpSessionState object.
        ' Session state may not be configured.
        Try
            sb.Append("Number of items in Session state: " & _
                Context.Session.Count.ToString() & "<br/>")
        Catch ex As Exception
            sb.Append("Session state not enabled. <br/>")
        End Try

        ' Use the current HttpContext object to access the current Cache object.
        sb.Append("Number of items in the cache: " & _
            Context.Cache.Count.ToString() & "<br/>")

        ' Use the current HttpContext object to determine the timestamp for the current HTTP Request.
        sb.Append("Timestamp for the HTTP request: " & _
            Context.Timestamp.ToString() & "<br/>")

        ' Assign StringBuilder object to output label.
        OutputLabel.Text = sb.ToString()
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpContext Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       Using the current HttpContext to get information about the current page.
       <br />
       <asp:Label id="OutputLabel" runat="server"></asp:Label>           
    </div>
    </form>
</body>
</html>

Keterangan

Kelas yang mewarisi IHttpModule antarmuka dan IHttpHandler diberikan referensi ke HttpContext objek untuk permintaan HTTP saat ini. Objek menyediakan akses ke properti intrinsik Request, Response, dan Server untuk permintaan tersebut.

Penting

Objek ini siap untuk pengumpulan HttpRequest sampah ketika selesai. Penggunaannya setelah permintaan selesai dapat menyebabkan perilaku yang tidak terdefinisi, seperti NullReferenceException.

Objek ini hanya tersedia di utas yang dikontrol oleh ASP.NET. Penggunaan di utas latar belakang dapat menyebabkan perilaku yang tidak terdefinisi.

Konstruktor

HttpContext(HttpRequest, HttpResponse)	Menginisialisasi instans HttpContext baru kelas dengan menggunakan objek permintaan dan respons yang ditentukan.
HttpContext(HttpWorkerRequest)	Menginisialisasi instans HttpContext baru kelas yang menggunakan objek permintaan pekerja yang ditentukan.

Properti

AllErrors	Mendapatkan array kesalahan yang terakumulasi saat memproses permintaan HTTP.
AllowAsyncDuringSyncStages	Mendapatkan atau menetapkan nilai yang menunjukkan apakah operasi asinkron diizinkan selama bagian ASP.NET pemrosesan permintaan ketika tidak diharapkan.
Application	HttpApplicationState Mendapatkan objek untuk permintaan HTTP saat ini.
ApplicationInstance	Mendapatkan atau mengatur HttpApplication objek untuk permintaan HTTP saat ini.
AsyncPreloadMode	Mendapatkan atau mengatur objek yang berisi bendera yang berkaitan dengan mode pramuat asinkron.
Cache	Cache Mendapatkan objek untuk domain aplikasi saat ini.
Current	Mendapatkan atau mengatur HttpContext objek untuk permintaan HTTP saat ini.
CurrentHandler	IHttpHandler Mendapatkan objek yang mewakili handler yang sedang dijalankan.
CurrentNotification	Mendapatkan nilai yang menunjukkan peristiwa saat ini HttpApplication yang sedang diprosesRequestNotification.
Error	Mendapatkan kesalahan pertama (jika ada) yang terakumulasi selama pemrosesan permintaan HTTP.
Handler	Mendapatkan atau mengatur objek yang IHttpHandler bertanggung jawab untuk memproses permintaan HTTP.
IsCustomErrorEnabled	Mendapatkan nilai yang menunjukkan apakah kesalahan kustom diaktifkan untuk permintaan HTTP saat ini.
IsDebuggingEnabled	Mendapatkan nilai yang menunjukkan apakah permintaan HTTP saat ini berada dalam mode debug.
IsPostNotification	Mendapatkan nilai yang merupakan titik pemrosesan saat ini dalam alur ASP.NET tepat setelah HttpApplication peristiwa selesai diproses.
IsWebSocketRequest	Mendapatkan nilai yang menunjukkan apakah permintaan tersebut adalah AspNetWebSocket permintaan.
IsWebSocketRequestUpgrading	Mendapatkan nilai yang menunjukkan apakah koneksi sedang ditingkatkan dari koneksi HTTP ke AspNetWebSocket koneksi.
Items	Mendapatkan koleksi kunci/nilai yang dapat digunakan untuk mengatur dan berbagi data antara IHttpModule antarmuka dan IHttpHandler antarmuka selama permintaan HTTP.
PageInstrumentation	Mendapatkan referensi ke instans layanan instrumentasi halaman untuk permintaan ini.
PreviousHandler	IHttpHandler Mendapatkan objek untuk handler induk.
Profile	ProfileBase Mendapatkan objek untuk profil pengguna saat ini.
Request	HttpRequest Mendapatkan objek untuk permintaan HTTP saat ini.
Response	HttpResponse Mendapatkan objek untuk respons HTTP saat ini.
Server	HttpServerUtility Mendapatkan objek yang menyediakan metode yang digunakan dalam memproses permintaan Web.
Session	HttpSessionState Mendapatkan objek untuk permintaan HTTP saat ini.
SkipAuthorization	Mendapatkan atau menetapkan nilai yang menentukan apakah UrlAuthorizationModule objek harus melewati pemeriksaan otorisasi untuk permintaan saat ini.
ThreadAbortOnTimeout	Mendapatkan atau menetapkan nilai yang menentukan apakah runtime ASP.NET harus memanggil Abort() pada utas yang melayani permintaan ini saat waktu permintaan habis.
Timestamp	Mendapatkan tanda waktu awal permintaan HTTP saat ini.
Trace	TraceContext Mendapatkan objek untuk respons HTTP saat ini.
User	Mendapatkan atau mengatur informasi keamanan untuk permintaan HTTP saat ini.
WebSocketNegotiatedProtocol	Mendapatkan protokol yang dinegosiasikan yang dikirim dari server ke klien untuk AspNetWebSocket koneksi.
WebSocketRequestedProtocols	Mendapatkan daftar protokol yang diurutkan yang diminta oleh klien.

Metode

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	AspNetWebSocket Menerima permintaan menggunakan fungsi pengguna yang ditentukan.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	AspNetWebSocket Menerima permintaan menggunakan fungsi pengguna dan objek opsi yang ditentukan.
AddError(Exception)	Menambahkan pengecualian ke kumpulan pengecualian untuk permintaan HTTP saat ini.
AddOnRequestCompleted(Action<HttpContext>)	Menaikkan peristiwa virtual yang terjadi ketika bagian HTTP dari permintaan berakhir.
ClearError()	Menghapus semua kesalahan untuk permintaan HTTP saat ini.
DisposeOnPipelineCompleted(IDisposable)	Memungkinkan metode objek Dispose() dipanggil ketika AspNetWebSocket bagian koneksi dari permintaan ini selesai.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetAppConfig(String)	Kedaluwarsa. Mengembalikan informasi konfigurasi yang diminta untuk aplikasi saat ini.
GetConfig(String)	Kedaluwarsa. Mengembalikan informasi konfigurasi yang diminta untuk permintaan HTTP saat ini.
GetGlobalResourceObject(String, String)	Mendapatkan objek sumber daya tingkat aplikasi berdasarkan properti dan ResourceKey yang ditentukanClassKey.
GetGlobalResourceObject(String, String, CultureInfo)	Mendapatkan objek sumber daya tingkat aplikasi berdasarkan properti dan ResourceKey yang ditentukanClassKey, dan pada CultureInfo objek .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLocalResourceObject(String, String)	Mendapatkan objek sumber daya tingkat halaman berdasarkan properti dan ResourceKey yang ditentukanVirtualPath.
GetLocalResourceObject(String, String, CultureInfo)	Mendapatkan objek sumber daya tingkat halaman berdasarkan properti dan ResourceKey yang ditentukanVirtualPath, dan pada CultureInfo objek .
GetSection(String)	Mendapatkan bagian konfigurasi tertentu untuk konfigurasi default aplikasi saat ini.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RemapHandler(IHttpHandler)	Memungkinkan Anda menentukan handler untuk permintaan tersebut.
RewritePath(String)	Menulis ulang URL menggunakan jalur yang diberikan.
RewritePath(String, Boolean)	Menulis ulang URL menggunakan jalur yang diberikan dan nilai Boolean yang menentukan apakah jalur virtual untuk sumber daya server dimodifikasi.
RewritePath(String, String, String)	Menulis ulang URL dengan menggunakan informasi jalur, informasi jalur, dan string kueri yang diberikan.
RewritePath(String, String, String, Boolean)	Menulis ulang URL menggunakan jalur virtual yang diberikan, informasi jalur, informasi string kueri, dan nilai Boolean yang menentukan apakah jalur file klien diatur ke jalur penulisan ulang.
SetSessionStateBehavior(SessionStateBehavior)	Mengatur jenis perilaku status sesi yang diperlukan untuk mendukung permintaan HTTP.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IServiceProvider.GetService(Type)

Mengembalikan objek untuk jenis layanan saat ini.

Metode Ekstensi

GetKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis `T` dari IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Mendapatkan enumerasi layanan jenis `serviceType` dari IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Mendapatkan enumerasi layanan jenis `T` dari IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Mendapatkan layanan jenis `serviceType` dari IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis `T` dari IServiceProvider.
CreateAsyncScope(IServiceProvider)	Membuat baru AsyncServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
CreateScope(IServiceProvider)	Membuat baru IServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
GetRequiredService(IServiceProvider, Type)	Dapatkan layanan jenis `serviceType` dari IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Dapatkan layanan jenis `T` dari IServiceProvider.
GetService<T>(IServiceProvider)	Dapatkan layanan jenis `T` dari IServiceProvider.
GetServices(IServiceProvider, Type)	Dapatkan enumerasi layanan jenis `serviceType` dari IServiceProvider.
GetServices<T>(IServiceProvider)	Dapatkan enumerasi layanan jenis `T` dari IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Mendapatkan objek yang mengumpulkan rekaman log yang dikirim ke pencatat palsu.
GetFakeRedactionCollector(IServiceProvider)	Mendapatkan instans pengumpul redactor palsu dari kontainer injeksi dependensi.

Berlaku untuk