HttpContext Sınıf

Başvuru

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 Page ö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 `serviceType`IServiceProviderhizmet alın.
GetRequiredService<T>(IServiceProvider)	türünden `T`IServiceProviderhizmet alın.
GetService<T>(IServiceProvider)	türünden `T`IServiceProviderhizmet alın.
GetServices(IServiceProvider, Type)	türünde bir hizmet `serviceType`IServiceProviderlistesi alın.
GetServices<T>(IServiceProvider)	türünde bir hizmet `T`IServiceProviderlistesi 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