HttpContext Kelas
Definisi
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 : IServiceProviderpublic sealed class HttpContext : IServiceProvidertype HttpContext = class
interface IServiceProviderPublic 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. |
