HttpContext Sınıf

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Tek bir HTTP isteği hakkında HTTP'ye özgü tüm bilgileri kapsüller.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Devralma: Object
HttpContext

Uygulamalar: IServiceProvider

Örnekler

Aşağıdaki örnekte nesnenin özelliklerine nasıl erişilip görüntüleneceği gösterilmektedir HttpContext . Geçerli HTTP isteğinin bağlamı nesnenin Context özelliği Page kullanılarak erişilir.

<%@ 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>

Açıklamalar

ve IHttpHandler arabirimlerini devralan IHttpModule sınıflara, geçerli HTTP isteği için bir HttpContext nesneye başvuru sağlanır. nesnesi, isteğin Requestiç , Responseve Server özelliklerine erişim sağlar.

Önemli

Tamamlandığında bu nesne çöp toplama için HttpRequest hazır. İstek tamamlandıktan sonra kullanımı, gibi tanımsız davranışlara NullReferenceExceptionyol açabilir.

Bu nesne yalnızca ASP.NET tarafından denetlenen iş parçacığında kullanılabilir. Arka plan iş parçacıklarında kullanım tanımsız davranışa yol açabilir.

Oluşturucular

Name	Description
HttpContext(HttpRequest, HttpResponse)	Belirtilen istek ve yanıt nesnelerini kullanarak sınıfının yeni bir örneğini HttpContext başlatır.
HttpContext(HttpWorkerRequest)	Belirtilen worker-request nesnesini kullanan sınıfın yeni bir örneğini HttpContext başlatır.

Özellikler

Name	Description
AllErrors	BIR HTTP isteği işlenirken biriken bir dizi hata alır.
AllowAsyncDuringSyncStages	ASP.NET istek işlemesinin bazı bölümlerinde zaman uyumsuz işlemlere izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar.
Application	HttpApplicationState Geçerli HTTP isteğinin nesnesini alır.
ApplicationInstance	Geçerli HTTP isteği için nesnesini alır veya ayarlar HttpApplication .
AsyncPreloadMode	Zaman uyumsuz ön yükleme moduna ait bayraklar içeren bir nesneyi alır veya ayarlar.
Cache	Cache Geçerli uygulama etki alanının nesnesini alır.
Current	Geçerli HTTP isteği için nesnesini alır veya ayarlar HttpContext .
CurrentHandler	IHttpHandler Şu anda yürütülen işleyiciyi temsil eden nesneyi alır.
CurrentNotification	İşleyen geçerli HttpApplication olayı gösteren bir RequestNotification değer alır.
Error	HTTP isteği işlenirken biriken ilk hatayı (varsa) alır.
Handler	HTTP isteğini işlemeden IHttpHandler sorumlu nesneyi alır veya ayarlar.
IsCustomErrorEnabled	Geçerli HTTP isteği için özel hataların etkinleştirilip etkinleştirilmediğini gösteren bir değer alır.
IsDebuggingEnabled	Geçerli HTTP isteğinin hata ayıklama modunda olup olmadığını belirten bir değer alır.
IsPostNotification	Bir olayın işlenmesi tamamlandıktan hemen sonra ASP.NET işlem hattındaki geçerli işlem noktası olan bir HttpApplication değer alır.
IsWebSocketRequest	İsteğin bir istek olup olmadığını gösteren bir AspNetWebSocket değer alır.
IsWebSocketRequestUpgrading	Bağlantının HTTP bağlantısından bir bağlantıya yükseltilip yükseltildiğini belirten bir AspNetWebSocket değer alır.
Items	HTTP isteği sırasında arabirim ile arabirim arasında IHttpModule veri düzenlemek ve paylaşmak için kullanılabilecek bir IHttpHandler anahtar/değer koleksiyonu alır.
PageInstrumentation	Bu istek için sayfa izleme hizmeti örneğine başvuru alır.
PreviousHandler	IHttpHandler Üst işleyici için nesnesini alır.
Profile	ProfileBase Geçerli kullanıcı profilinin nesnesini alır.
Request	HttpRequest Geçerli HTTP isteğinin nesnesini alır.
Response	HttpResponse Geçerli HTTP yanıtının nesnesini alır.
Server	HttpServerUtility Web isteklerini işlerken kullanılan yöntemleri sağlayan nesnesini alır.
Session	HttpSessionState Geçerli HTTP isteğinin nesnesini alır.
SkipAuthorization	Nesnenin UrlAuthorizationModule geçerli istek için yetkilendirme denetimini atlayıp atlamayacağını belirten bir değer alır veya ayarlar.
ThreadAbortOnTimeout	İstek zaman aşımına uğradıklarında ASP.NET çalışma zamanının bu isteğe hizmet veren iş parçacığında çağrı Abort() yapıp yapmadığını belirten bir değer alır veya ayarlar.
Timestamp	Geçerli HTTP isteğinin ilk zaman damgasını alır.
Trace	TraceContext Geçerli HTTP yanıtının nesnesini alır.
User	Geçerli HTTP isteği için güvenlik bilgilerini alır veya ayarlar.
WebSocketNegotiatedProtocol	Bir bağlantı için AspNetWebSocket sunucudan istemciye gönderilen anlaşmalı protokolü alır.
WebSocketRequestedProtocols	İstemci tarafından istenen protokollerin sıralı listesini alır.

Yöntemler

Name	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	Belirtilen kullanıcı işlevini ve options nesnesini kullanarak bir AspNetWebSocket isteği kabul eder.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	Belirtilen kullanıcı işlevini kullanarak bir AspNetWebSocket isteği kabul eder.
AddError(Exception)	Geçerli HTTP isteği için özel durum koleksiyonuna bir özel durum ekler.
AddOnRequestCompleted(Action<HttpContext>)	İsteğin HTTP bölümü sona erdiğinde gerçekleşen bir sanal olay oluşturur.
ClearError()	Geçerli HTTP isteği için tüm hataları temizler.
DisposeOnPipelineCompleted(IDisposable)	Bu isteğin Dispose() bağlantı bölümü tamamlandığında nesnenin AspNetWebSocket yönteminin çağrılmaya olanak tanır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetAppConfig(String)	Geçersiz. Geçerli uygulama için istenen yapılandırma bilgilerini döndürür.
GetConfig(String)	Geçersiz. Geçerli HTTP isteği için istenen yapılandırma bilgilerini döndürür.
GetGlobalResourceObject(String, String, CultureInfo)	Belirtilen ClassKey ve ResourceKey özelliklere CultureInfo ve nesneye göre uygulama düzeyinde bir kaynak nesnesi alır.
GetGlobalResourceObject(String, String)	Belirtilen ClassKey ve ResourceKey özelliklerine göre uygulama düzeyinde bir kaynak nesnesi alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLocalResourceObject(String, String, CultureInfo)	Belirtilen VirtualPath ve ResourceKey özelliklere CultureInfo ve nesneye göre sayfa düzeyinde bir kaynak nesnesi alır.
GetLocalResourceObject(String, String)	Belirtilen VirtualPath ve ResourceKey özelliklerine göre sayfa düzeyinde bir kaynak nesnesi alır.
GetSection(String)	Geçerli uygulamanın varsayılan yapılandırması için belirtilen yapılandırma bölümünü alır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
RemapHandler(IHttpHandler)	İstek için bir işleyici belirtmenizi sağlar.
RewritePath(String, Boolean)	Verilen yolu ve sunucu kaynakları için sanal yolun değiştirilip değiştirilmediğini belirten bir Boole değeri kullanarak URL'yi yeniden yazar.
RewritePath(String, String, String, Boolean)	Verilen sanal yolu, yol bilgilerini, sorgu dizesi bilgilerini ve istemci dosya yolunun yeniden yazma yoluna ayarlanıp ayarlanmadığını belirten bir Boole değeri kullanarak URL'yi yeniden yazar.
RewritePath(String, String, String)	Verilen yolu, yol bilgilerini ve sorgu dizesi bilgilerini kullanarak URL'yi yeniden yazar.
RewritePath(String)	Verilen yolu kullanarak URL'yi yeniden yazar.
SetSessionStateBehavior(SessionStateBehavior)	HTTP isteğini desteklemek için gereken oturum durumu davranışının türünü ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
IServiceProvider.GetService(Type)	Geçerli hizmet türü için bir nesne döndürür.

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?