Bagikan melalui


HttpContext Kelas

Definisi

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

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

Lihat juga