HttpContext Klas

Definitie

Naamruimte:: System.Web

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Bevat alle HTTP-specifieke informatie over een afzonderlijke HTTP-aanvraag.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Overname: Object
HttpContext

Implementeringen: IServiceProvider

Voorbeelden

In het volgende voorbeeld ziet u hoe u de eigenschappen van het HttpContext object kunt openen en weergeven. De context van de huidige HTTP-aanvraag wordt geopend met behulp van de Context eigenschap van het Page object.

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

Opmerkingen

Klassen die de IHttpModule en IHttpHandler interfaces overnemen, krijgen een verwijzing naar een HttpContext object voor de huidige HTTP-aanvraag. Het object biedt toegang tot de intrinsieke Request, Responseen Server eigenschappen voor de aanvraag.

Important

Dit object is gereed voor garbagecollection wanneer het HttpRequest is voltooid. Het gebruik ervan nadat de aanvraag is voltooid, kan leiden tot niet-gedefinieerd gedrag, zoals een NullReferenceException.

Dit object is alleen beschikbaar in de thread die wordt beheerd door ASP.NET. Gebruik in achtergrondthreads kan leiden tot niet-gedefinieerd gedrag.

Constructors

Name	Description
HttpContext(HttpRequest, HttpResponse)	Initialiseert een nieuw exemplaar van de HttpContext klasse met behulp van de opgegeven aanvraag- en antwoordobjecten.
HttpContext(HttpWorkerRequest)	Initialiseert een nieuw exemplaar van de HttpContext klasse die gebruikmaakt van het opgegeven werkrolaanvraagobject.

Eigenschappen

Name	Description
AllErrors	Hiermee wordt een matrix met fouten opgehaald die zijn verzameld tijdens het verwerken van een HTTP-aanvraag.
AllowAsyncDuringSyncStages	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of asynchrone bewerkingen zijn toegestaan tijdens delen van ASP.NET aanvraagverwerking wanneer ze niet worden verwacht.
Application	Hiermee haalt u het HttpApplicationState object op voor de huidige HTTP-aanvraag.
ApplicationInstance	Hiermee wordt het HttpApplication object opgehaald of ingesteld voor de huidige HTTP-aanvraag.
AsyncPreloadMode	Hiermee wordt een object opgehaald of ingesteld dat vlaggen bevat die betrekking hebben op de asynchrone preloadmodus.
Cache	Hiermee haalt u het Cache object op voor het huidige toepassingsdomein.
Current	Hiermee wordt het HttpContext object opgehaald of ingesteld voor de huidige HTTP-aanvraag.
CurrentHandler	Hiermee haalt u het IHttpHandler object op dat de huidige handler vertegenwoordigt.
CurrentNotification	Hiermee wordt een RequestNotification waarde opgehaald die de huidige HttpApplication gebeurtenis aangeeft die wordt verwerkt.
Error	Hiermee wordt de eerste fout (indien aanwezig) opgehaald die is verzameld tijdens het verwerken van HTTP-aanvragen.
Handler	Hiermee wordt het IHttpHandler object opgehaald of ingesteld dat verantwoordelijk is voor het verwerken van de HTTP-aanvraag.
IsCustomErrorEnabled	Hiermee wordt een waarde opgehaald die aangeeft of aangepaste fouten zijn ingeschakeld voor de huidige HTTP-aanvraag.
IsDebuggingEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de huidige HTTP-aanvraag zich in de foutopsporingsmodus bevindt.
IsPostNotification	Hiermee wordt een waarde opgehaald die het huidige verwerkingspunt in de ASP.NET-pijplijn is, net nadat een HttpApplication gebeurtenis is verwerkt.
IsWebSocketRequest	Hiermee wordt een waarde opgehaald die aangeeft of de aanvraag een AspNetWebSocket aanvraag is.
IsWebSocketRequestUpgrading	Hiermee wordt een waarde opgehaald die aangeeft of de verbinding een upgrade uitvoert van een HTTP-verbinding naar een AspNetWebSocket verbinding.
Items	Hiermee haalt u een sleutel/waardeverzameling op die kan worden gebruikt om gegevens te ordenen en te delen tussen een IHttpModule interface en een IHttpHandler interface tijdens een HTTP-aanvraag.
PageInstrumentation	Haalt een verwijzing op naar het pagina-instrumentatieservice-exemplaar voor deze aanvraag.
PreviousHandler	Hiermee haalt u het IHttpHandler object op voor de bovenliggende handler.
Profile	Hiermee haalt u het ProfileBase object op voor het huidige gebruikersprofiel.
Request	Hiermee haalt u het HttpRequest object op voor de huidige HTTP-aanvraag.
Response	Hiermee haalt u het HttpResponse object op voor het huidige HTTP-antwoord.
Server	Hiermee haalt u het object op dat methoden biedt die worden gebruikt bij het HttpServerUtility verwerken van webaanvragen.
Session	Hiermee haalt u het HttpSessionState object op voor de huidige HTTP-aanvraag.
SkipAuthorization	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het UrlAuthorizationModule object de autorisatiecontrole voor de huidige aanvraag moet overslaan.
ThreadAbortOnTimeout	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ASP.NET runtime Abort() moet aanroepen op de thread die deze aanvraag onderhoudt wanneer er een time-out optreedt voor de aanvraag.
Timestamp	Hiermee wordt de eerste tijdstempel van de huidige HTTP-aanvraag opgehaald.
Trace	Hiermee haalt u het TraceContext object op voor het huidige HTTP-antwoord.
User	Hiermee worden beveiligingsgegevens opgehaald of ingesteld voor de huidige HTTP-aanvraag.
WebSocketNegotiatedProtocol	Haalt het onderhandelde protocol op dat van de server naar de client is verzonden voor een AspNetWebSocket verbinding.
WebSocketRequestedProtocols	Hiermee haalt u de geordende lijst met protocollen op die door de client worden aangevraagd.

Methoden

Name	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	Accepteert een AspNetWebSocket aanvraag met behulp van de opgegeven gebruikersfunctie en het optiesobject.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	Accepteert een AspNetWebSocket aanvraag met behulp van de opgegeven gebruikersfunctie.
AddError(Exception)	Hiermee voegt u een uitzondering toe aan de uitzonderingsverzameling voor de huidige HTTP-aanvraag.
AddOnRequestCompleted(Action<HttpContext>)	Hiermee wordt een virtuele gebeurtenis gegenereerd die optreedt wanneer het HTTP-deel van de aanvraag eindigt.
ClearError()	Alle fouten voor de huidige HTTP-aanvraag worden gewist.
DisposeOnPipelineCompleted(IDisposable)	Hiermee kan de methode van Dispose() een object worden aangeroepen wanneer het AspNetWebSocket verbindingsgedeelte van deze aanvraag is voltooid.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetAppConfig(String)	Verouderd. Retourneert aangevraagde configuratiegegevens voor de huidige toepassing.
GetConfig(String)	Verouderd. Retourneert aangevraagde configuratiegegevens voor de huidige HTTP-aanvraag.
GetGlobalResourceObject(String, String, CultureInfo)	Hiermee haalt u een resourceobject op toepassingsniveau op op basis van de opgegeven ClassKey eigenschappen en ResourceKey op het CultureInfo object.
GetGlobalResourceObject(String, String)	Hiermee wordt een resourceobject op toepassingsniveau opgehaald op basis van de opgegeven ClassKey eigenschappen en ResourceKey eigenschappen.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLocalResourceObject(String, String, CultureInfo)	Hiermee haalt u een resourceobject op paginaniveau op op basis van de opgegeven VirtualPath eigenschappen en ResourceKey op het CultureInfo object.
GetLocalResourceObject(String, String)	Hiermee haalt u een resourceobject op paginaniveau op op basis van de opgegeven VirtualPath eigenschappen en ResourceKey eigenschappen.
GetSection(String)	Hiermee haalt u een opgegeven configuratiesectie op voor de standaardconfiguratie van de huidige toepassing.
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
RemapHandler(IHttpHandler)	Hiermee kunt u een handler voor de aanvraag opgeven.
RewritePath(String, Boolean)	Herschrijf de URL met behulp van het opgegeven pad en een Booleaanse waarde die aangeeft of het virtuele pad voor serverresources wordt gewijzigd.
RewritePath(String, String, String, Boolean)	Herschrijf de URL met behulp van het opgegeven virtuele pad, padinformatie, querytekenreeksinformatie en een Booleaanse waarde die aangeeft of het pad naar het clientbestand is ingesteld op het herschrijfpad.
RewritePath(String, String, String)	Herschrijf de URL met behulp van het opgegeven pad, padinformatie en querytekenreeksgegevens.
RewritePath(String)	Herschrijf de URL met behulp van het opgegeven pad.
SetSessionStateBehavior(SessionStateBehavior)	Hiermee stelt u het type sessiestatusgedrag in dat is vereist om een HTTP-aanvraag te ondersteunen.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Expliciete interface-implementaties

Name	Description
IServiceProvider.GetService(Type)	Retourneert een object voor het huidige servicetype.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?