HttpContext Osztály

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Beágyazza az egyes HTTP-kérésekkel kapcsolatos ÖSSZES HTTP-specifikus információt.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Öröklődés: Object
HttpContext

Megvalósítás: IServiceProvider

Példák

Az alábbi példa bemutatja, hogyan érheti el és jelenítheti meg az HttpContext objektum tulajdonságait. Az aktuális HTTP-kérés környezete az objektum tulajdonságával Context érhető elPage.

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

Megjegyzések

Azokat az osztályokat, amelyek öröklik azokat IHttpModule és IHttpHandler a felületeket, az aktuális HTTP-kérés objektumára HttpContext mutató hivatkozást kapnak. Az objektum hozzáférést biztosít a kérés belső Request, Responseés Server tulajdonságaihoz.

Important

Ez az objektum készen áll a szemétgyűjtésre a HttpRequest befejezéskor. A kérés befejezése utáni használata meghatározatlan viselkedéshez vezethet, például egy NullReferenceException.

Ez az objektum csak a ASP.NET által szabályozott szálban érhető el. A háttérszálak használata meghatározatlan viselkedéshez vezethet.

Konstruktorok

Name	Description
HttpContext(HttpRequest, HttpResponse)	Inicializálja az HttpContext osztály új példányát a megadott kérés- és válaszobjektumok használatával.
HttpContext(HttpWorkerRequest)	Inicializálja a HttpContext megadott feldolgozó-kérelem objektumot használó osztály új példányát.

Tulajdonságok

Name	Description
AllErrors	A HTTP-kérés feldolgozása során felhalmozott hibák tömbje.
AllowAsyncDuringSyncStages	Lekéri vagy beállít egy értéket, amely jelzi, hogy az aszinkron műveletek engedélyezettek-e ASP.NET kérésfeldolgozás egyes részeiben, amikor azok nem várhatók.
Application	Lekéri az HttpApplicationState aktuális HTTP-kérés objektumát.
ApplicationInstance	Lekéri vagy beállítja az HttpApplication aktuális HTTP-kérés objektumát.
AsyncPreloadMode	Lekéri vagy beállít egy objektumot, amely az aszinkron előtöltési módhoz kapcsolódó jelzőket tartalmaz.
Cache	Lekéri az Cache aktuális alkalmazástartomány objektumát.
Current	Lekéri vagy beállítja az HttpContext aktuális HTTP-kérés objektumát.
CurrentHandler	Lekéri a IHttpHandler jelenleg végrehajtó kezelőt képviselő objektumot.
CurrentNotification	RequestNotification Olyan értéket kap, amely a HttpApplication jelenleg feldolgozásra kerülő eseményt jelzi.
Error	Lekéri a HTTP-kérések feldolgozása során felhalmozott első hibát (ha van ilyen).
Handler	Lekéri vagy beállítja a IHttpHandler HTTP-kérés feldolgozásáért felelős objektumot.
IsCustomErrorEnabled	Beolvas egy értéket, amely jelzi, hogy az egyéni hibák engedélyezve vannak-e az aktuális HTTP-kéréshez.
IsDebuggingEnabled	Beolvas egy értéket, amely jelzi, hogy az aktuális HTTP-kérés hibakeresési módban van-e.
IsPostNotification	A ASP.NET folyamat aktuális feldolgozási pontjának megfelelő értéket kap, miután egy HttpApplication esemény befejeződött.
IsWebSocketRequest	Olyan értéket kap, amely jelzi, hogy a kérés kérés-e AspNetWebSocket .
IsWebSocketRequestUpgrading	Lekéri azt az értéket, amely jelzi, hogy a kapcsolat HTTP-kapcsolatról egy kapcsolatra AspNetWebSocket frissül-e.
Items	Lekéri azokat a kulcs-/értékgyűjteményeket, amelyek segítségével rendszerezheti és megoszthatja az adatokat egy IHttpModule interfész és egy IHttpHandler interfész között egy HTTP-kérés során.
PageInstrumentation	Lekéri a kérés lap-rendszerállapot szolgáltatáspéldányára mutató hivatkozást.
PreviousHandler	Lekéri a IHttpHandler szülőkezelő objektumát.
Profile	Lekéri az ProfileBase aktuális felhasználói profil objektumát.
Request	Lekéri az HttpRequest aktuális HTTP-kérés objektumát.
Response	Lekéri az HttpResponse aktuális HTTP-válasz objektumát.
Server	Lekéri a HttpServerUtility webes kérelmek feldolgozásához használt metódusokat biztosító objektumot.
Session	Lekéri az HttpSessionState aktuális HTTP-kérés objektumát.
SkipAuthorization	Lekéri vagy beállít egy értéket, amely meghatározza, hogy az UrlAuthorizationModule objektum kihagyja-e az aktuális kérelem engedélyezési ellenőrzését.
ThreadAbortOnTimeout	Lekéri vagy beállít egy értéket, amely meghatározza, hogy a ASP.NET futtatókörnyezet meghívja-e a kérést karbantartó szálon a Abort(), amikor a kérés túllépi az időkorlátot.
Timestamp	Lekéri az aktuális HTTP-kérés kezdeti időbélyegét.
Trace	Lekéri az TraceContext aktuális HTTP-válasz objektumát.
User	Lekéri vagy beállítja az aktuális HTTP-kérés biztonsági adatait.
WebSocketNegotiatedProtocol	Lekéri a kiszolgálóról az ügyfélnek egy kapcsolatra küldött egyeztetett protokollt AspNetWebSocket .
WebSocketRequestedProtocols	Lekéri az ügyfél által kért protokollok rendezett listáját.

Metódusok

Name	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	A megadott felhasználói függvény és beállításobjektum használatával fogad el egy AspNetWebSocket kérést.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	A megadott felhasználói függvény használatával fogad el egy kérést AspNetWebSocket .
AddError(Exception)	Kivételt ad hozzá az aktuális HTTP-kérés kivételgyűjteményéhez.
AddOnRequestCompleted(Action<HttpContext>)	Olyan virtuális eseményt hoz létre, amely akkor következik be, amikor a kérés HTTP-része véget ér.
ClearError()	Törli az aktuális HTTP-kérés összes hibáját.
DisposeOnPipelineCompleted(IDisposable)	Lehetővé teszi egy objektum metódusának meghívását Dispose() a AspNetWebSocket kérés kapcsolati részének befejezésekor.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetAppConfig(String)	Elavult. Az aktuális alkalmazás kért konfigurációs adatait adja vissza.
GetConfig(String)	Elavult. Az aktuális HTTP-kérés kért konfigurációs adatait adja vissza.
GetGlobalResourceObject(String, String, CultureInfo)	Lekéri az alkalmazásszintű erőforrás-objektumot a megadott ClassKey és ResourceKey a tulajdonságok, valamint az CultureInfo objektum alapján.
GetGlobalResourceObject(String, String)	Lekéri az alkalmazásszintű erőforrás-objektumot a megadott ClassKey és ResourceKey a tulajdonságok alapján.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLocalResourceObject(String, String, CultureInfo)	Lekéri a lapszintű erőforrás-objektumot a megadott VirtualPath és ResourceKey a tulajdonságok, valamint az CultureInfo objektum alapján.
GetLocalResourceObject(String, String)	Lapszintű erőforrás-objektumot kap a megadott VirtualPath és ResourceKey a tulajdonságok alapján.
GetSection(String)	Lekéri az aktuális alkalmazás alapértelmezett konfigurációjának megadott konfigurációs szakaszát.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
RemapHandler(IHttpHandler)	Lehetővé teszi a kérés kezelőjének megadását.
RewritePath(String, Boolean)	Írja át az URL-címet a megadott elérési út és egy logikai érték használatával, amely meghatározza, hogy a kiszolgálóerőforrások virtuális elérési útja módosul-e.
RewritePath(String, String, String, Boolean)	Írja át az URL-címet a megadott virtuális elérési út, útvonaladatok, lekérdezési sztringadatok és logikai érték használatával, amely meghatározza, hogy az ügyfélfájl elérési útja az újraírási útvonalra van-e beállítva.
RewritePath(String, String, String)	Írja át az URL-címet a megadott elérési út, útvonaladatok és lekérdezési sztringadatok használatával.
RewritePath(String)	Írja át az URL-címet a megadott elérési út használatával.
SetSessionStateBehavior(SessionStateBehavior)	Beállítja a HTTP-kérések támogatásához szükséges munkamenetállapot-viselkedés típusát.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
IServiceProvider.GetService(Type)	Az aktuális szolgáltatástípus objektumát adja vissza.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?