HttpContext Klass

Definition

Namnområde:: System.Web

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Kapslar in all HTTP-specifik information om en enskild HTTP-begäran.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Arv: Object
HttpContext

Implementeringar: IServiceProvider

Exempel

I följande exempel visas hur du kommer åt och visar objektets HttpContext egenskaper. Kontexten för den aktuella HTTP-begäran nås med hjälp Context av objektets Page egenskap.

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

Kommentarer

Klasser som ärver gränssnitten IHttpModule och IHttpHandler tillhandahålls en referens till ett HttpContext objekt för den aktuella HTTP-begäran. Objektet ger åtkomst till de inbyggda Requestegenskaperna , Responseoch Server för begäran.

Important

Det här objektet är redo för skräpinsamling när det HttpRequest har slutförts. Dess användning när begäran har slutförts kan leda till odefinierat beteende, till exempel en NullReferenceException.

Det här objektet är bara tillgängligt i tråden som styrs av ASP.NET. Användning i bakgrundstrådar kan leda till odefinierat beteende.

Konstruktorer

Name	Description
HttpContext(HttpRequest, HttpResponse)	Initierar en ny instans av HttpContext klassen med hjälp av de angivna begärande- och svarsobjekten.
HttpContext(HttpWorkerRequest)	Initierar en ny instans av HttpContext klassen som använder det angivna arbetsbegärandeobjektet.

Egenskaper

Name	Description
AllErrors	Hämtar en matris med fel som ackumulerats vid bearbetning av en HTTP-begäran.
AllowAsyncDuringSyncStages	Hämtar eller anger ett värde som anger om asynkrona åtgärder tillåts under delar av ASP.NET bearbetning av begäranden när de inte förväntas.
Application	Hämtar objektet HttpApplicationState för den aktuella HTTP-begäran.
ApplicationInstance	Hämtar eller anger objektet HttpApplication för den aktuella HTTP-begäran.
AsyncPreloadMode	Hämtar eller anger ett objekt som innehåller flaggor som gäller asynkront förinläsningsläge.
Cache	Hämtar objektet Cache för den aktuella programdomänen.
Current	Hämtar eller anger objektet HttpContext för den aktuella HTTP-begäran.
CurrentHandler	Hämtar objektet IHttpHandler som representerar hanteraren som körs just nu.
CurrentNotification	Hämtar ett RequestNotification värde som anger den aktuella HttpApplication händelsen som bearbetas.
Error	Hämtar det första felet (om det finns) som ackumulerats under BEARBETNING av HTTP-begäranden.
Handler	Hämtar eller anger det objekt som IHttpHandler ansvarar för att bearbeta HTTP-begäran.
IsCustomErrorEnabled	Hämtar ett värde som anger om anpassade fel är aktiverade för den aktuella HTTP-begäran.
IsDebuggingEnabled	Hämtar ett värde som anger om den aktuella HTTP-begäran är i felsökningsläge.
IsPostNotification	Hämtar ett värde som är den aktuella bearbetningspunkten i den ASP.NET pipelinen strax efter att en HttpApplication händelse har slutfört bearbetningen.
IsWebSocketRequest	Hämtar ett värde som anger om begäran är en AspNetWebSocket begäran.
IsWebSocketRequestUpgrading	Hämtar ett värde som anger om anslutningen uppgraderas från en HTTP-anslutning till en AspNetWebSocket anslutning.
Items	Hämtar en nyckel-/värdesamling som kan användas för att organisera och dela data mellan ett IHttpModule gränssnitt och ett IHttpHandler gränssnitt under en HTTP-begäran.
PageInstrumentation	Hämtar en referens till sidinstrumentationstjänstinstansen för den här begäran.
PreviousHandler	Hämtar objektet IHttpHandler för den överordnade hanteraren.
Profile	Hämtar objektet ProfileBase för den aktuella användarprofilen.
Request	Hämtar objektet HttpRequest för den aktuella HTTP-begäran.
Response	HttpResponse Hämtar objektet för det aktuella HTTP-svaret.
Server	Hämtar objektet HttpServerUtility som innehåller metoder som används för att bearbeta webbbegäranden.
Session	Hämtar objektet HttpSessionState för den aktuella HTTP-begäran.
SkipAuthorization	Hämtar eller anger ett värde som anger om UrlAuthorizationModule objektet ska hoppa över auktoriseringskontrollen för den aktuella begäran.
ThreadAbortOnTimeout	Hämtar eller anger ett värde som anger om ASP.NET-körningen ska anropa Abort() på tråden som betjänar den här begäran när begäran överskrider tidsgränsen.
Timestamp	Hämtar den första tidsstämpeln för den aktuella HTTP-begäran.
Trace	TraceContext Hämtar objektet för det aktuella HTTP-svaret.
User	Hämtar eller anger säkerhetsinformation för den aktuella HTTP-begäran.
WebSocketNegotiatedProtocol	Hämtar det förhandlade protokollet som skickades från servern till klienten för en AspNetWebSocket anslutning.
WebSocketRequestedProtocols	Hämtar den ordnade listan över protokoll som begärs av klienten.

Metoder

Name	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	Accepterar en AspNetWebSocket begäran med hjälp av det angivna användarfunktions- och alternativobjektet.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	Accepterar en AspNetWebSocket begäran med den angivna användarfunktionen.
AddError(Exception)	Lägger till ett undantag i undantagssamlingen för den aktuella HTTP-begäran.
AddOnRequestCompleted(Action<HttpContext>)	Skapar en virtuell händelse som inträffar när HTTP-delen av begäran avslutas.
ClearError()	Rensar alla fel för den aktuella HTTP-begäran.
DisposeOnPipelineCompleted(IDisposable)	Gör att ett objekts metod anropas Dispose() när anslutningsdelen av den AspNetWebSocket här begäran har slutförts.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetAppConfig(String)	Föråldrad. Returnerar begärd konfigurationsinformation för det aktuella programmet.
GetConfig(String)	Föråldrad. Returnerar begärd konfigurationsinformation för den aktuella HTTP-begäran.
GetGlobalResourceObject(String, String, CultureInfo)	Hämtar ett resursobjekt på programnivå baserat på de angivna ClassKey egenskaperna och ResourceKey egenskaperna och på CultureInfo objektet.
GetGlobalResourceObject(String, String)	Hämtar ett resursobjekt på programnivå baserat på de angivna ClassKey egenskaperna och ResourceKey egenskaperna.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLocalResourceObject(String, String, CultureInfo)	Hämtar ett resursobjekt på sidnivå baserat på de angivna VirtualPath egenskaperna och ResourceKey egenskaperna och på CultureInfo objektet.
GetLocalResourceObject(String, String)	Hämtar ett resursobjekt på sidnivå baserat på angivna VirtualPath egenskaper och ResourceKey egenskaper.
GetSection(String)	Hämtar ett angivet konfigurationsavsnitt för det aktuella programmets standardkonfiguration.
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
RemapHandler(IHttpHandler)	Gör att du kan ange en hanterare för begäran.
RewritePath(String, Boolean)	Skriver om URL:en med den angivna sökvägen och ett booleskt värde som anger om den virtuella sökvägen för serverresurser ändras.
RewritePath(String, String, String, Boolean)	Skriver om URL:en med den angivna virtuella sökvägen, sökvägsinformation, frågesträngsinformation och ett booleskt värde som anger om klientfilens sökväg är inställd på sökvägen för omskrivning.
RewritePath(String, String, String)	Skriver om URL:en med hjälp av den angivna sökvägen, sökvägsinformationen och frågesträngsinformationen.
RewritePath(String)	Skriver om URL:en med den angivna sökvägen.
SetSessionStateBehavior(SessionStateBehavior)	Anger vilken typ av sessionstillståndsbeteende som krävs för att stödja en HTTP-begäran.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Explicita gränssnittsimplementeringar

Name	Description
IServiceProvider.GetService(Type)	Returnerar ett objekt för den aktuella tjänsttypen.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?