Aracılığıyla paylaş


HttpContext Sınıf

Tanım

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

Ö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 ContextPage özelliği 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 toplamaya 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

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

AllErrors

BIR HTTP isteği işlenirken biriken bir dizi hata alır.

AllowAsyncDuringSyncStages

ASP.NET isteğin bazı bölümleri beklenmediği zaman 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ğinin HttpApplication nesnesini alır veya ayarlar.

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ğinin HttpContext nesnesini alır veya ayarlar.

CurrentHandler

IHttpHandler Şu anda yürütülmekte olan işleyiciyi temsil eden nesneyi alır.

CurrentNotification

İşlenmekte olan 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 belirten 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şleme noktası olan değeri HttpApplication 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 verileri 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 nesneyi 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

Bağlantı için AspNetWebSocket sunucudan istemciye gönderilen, anlaşılan protokolü alır.

WebSocketRequestedProtocols

İstemci tarafından istenen protokollerin sıralı listesini alır.

Yöntemler

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

Belirtilen kullanıcı işlevini kullanarak bir AspNetWebSocket isteği kabul eder.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

Belirtilen kullanıcı işlevi ve seçenekler nesnesini 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 bir nesnenin yönteminin AspNetWebSocket ç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)

Belirtilen ClassKey ve ResourceKey özelliklerine göre uygulama düzeyinde bir kaynak nesnesi alır.

GetGlobalResourceObject(String, String, CultureInfo)

Belirtilen ClassKey ve ResourceKey özelliklerine CultureInfo ve nesnesine 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)

Belirtilen VirtualPath ve ResourceKey özelliklerine göre sayfa düzeyinde bir kaynak nesnesi alır.

GetLocalResourceObject(String, String, CultureInfo)

Belirtilen VirtualPath ve ResourceKey özelliklerine CultureInfo ve nesnesine 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()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
RemapHandler(IHttpHandler)

İstek için bir işleyici belirtmenizi sağlar.

RewritePath(String)

Verilen yolu kullanarak URL'yi yeniden yazar.

RewritePath(String, Boolean)

Verilen yolu ve sunucu kaynaklarının sanal yolunun değiştirilip değiştirilmediğini 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, 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.

SetSessionStateBehavior(SessionStateBehavior)

HTTP isteğini desteklemek için gereken oturum durumu davranışının türünü ayarlar.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IServiceProvider.GetService(Type)

Geçerli hizmet türü için bir nesne döndürür.

Uzantı Metotları

GetKeyedService<T>(IServiceProvider, Object)

türünde IServiceProviderbir hizmet T alır.

GetKeyedServices(IServiceProvider, Type, Object)

türünde hizmetlerin serviceType bir numaralandırmasını IServiceProvideralır.

GetKeyedServices<T>(IServiceProvider, Object)

türünde hizmetlerin T bir numaralandırmasını IServiceProvideralır.

GetRequiredKeyedService(IServiceProvider, Type, Object)

türünde IServiceProviderbir hizmet serviceType alır.

GetRequiredKeyedService<T>(IServiceProvider, Object)

türünde IServiceProviderbir hizmet T alır.

CreateAsyncScope(IServiceProvider)

Kapsamı belirlenmiş hizmetleri çözümlemek için kullanılabilecek yeni AsyncServiceScope bir oluşturur.

CreateScope(IServiceProvider)

Kapsamı belirlenmiş hizmetleri çözümlemek için kullanılabilecek yeni IServiceScope bir oluşturur.

GetRequiredService(IServiceProvider, Type)

türünden serviceTypeIServiceProviderhizmet alın.

GetRequiredService<T>(IServiceProvider)

türünden TIServiceProviderhizmet alın.

GetService<T>(IServiceProvider)

türünden TIServiceProviderhizmet alın.

GetServices(IServiceProvider, Type)

türünde bir hizmet serviceTypeIServiceProviderlistesi alın.

GetServices<T>(IServiceProvider)

türünde bir hizmet TIServiceProviderlistesi alın.

GetFakeLogCollector(IServiceProvider)

Sahte günlükçüye gönderilen günlük kayıtlarını toplayan nesneyi alır.

GetFakeRedactionCollector(IServiceProvider)

Bağımlılık ekleme kapsayıcısından sahte redaktör toplayıcı örneğini alır.

Şunlara uygulanır

Ayrıca bkz.