HttpContext Klasse

Definition

Kapselt alle HTTP-spezifischen Informationen über eine einzelne HTTP-Anforderung.Encapsulates all HTTP-specific information about an individual HTTP request.

public ref class HttpContext sealed : IServiceProvider
public sealed class HttpContext : IServiceProvider
type HttpContext = class
    interface IServiceProvider
Public NotInheritable Class HttpContext
Implements IServiceProvider
Vererbung
HttpContext
Implementiert

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie auf Eigenschaften des HttpContext Objekts zugreifen und diese anzeigen.The following example demonstrates how to access and display properties of the HttpContext object. Auf den Kontext der aktuellen HTTP-Anforderung wird mithilfe der Context-Eigenschaft des Page-Objekts zugegriffen.The context of the current HTTP request is accessed by using the Context property of the 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>

Hinweise

Klassen, die die IHttpModule-und IHttpHandler-Schnittstellen erben, werden als Verweis auf ein HttpContext-Objekt für die aktuelle HTTP-Anforderung bereitgestellt.Classes that inherit the IHttpModule and IHttpHandler interfaces are provided a reference to an HttpContext object for the current HTTP request. Das-Objekt bietet Zugriff auf die systeminternen Eigenschaften Request, Responseund Server für die Anforderung.The object provides access to the intrinsic Request, Response, and Server properties for the request.

Wichtig

Dieses Objekt ist bereit für Garbage Collection, wenn die HttpRequest abgeschlossen ist.This object is ready for garbage collection when the HttpRequest is completed. Die Verwendung nach Abschluss der Anforderung kann zu nicht definiertem Verhalten führen, wie z. b. einem NullReferenceException.Its usage after the request completes could lead to undefined behavior, such as a NullReferenceException.

Dieses Objekt ist nur in dem von ASP.net kontrollierten Thread verfügbar.This object is only available in the thread controlled by ASP.NET. Die Verwendung in Hintergrundthreads kann zu undefiniertem Verhalten führen.Usage in background threads could lead to undefined behavior.

Konstruktoren

HttpContext(HttpRequest, HttpResponse)

Initialisiert eine neue Instanz der HttpContext-Klasse mit den angegebenen Anforderungs- und Antwortobjekten.Initializes a new instance of the HttpContext class by using the specified request and response objects.

HttpContext(HttpWorkerRequest)

Initialisiert eine neue Instanz der HttpContext-Klasse mit dem angegebenen Arbeitsanforderungsobjekt.Initializes a new instance of the HttpContext class that uses the specified worker-request object.

Eigenschaften

AllErrors

Ruft ein Array von Fehlern ab, die beim Verarbeiten einer HTTP-Anforderung angesammelt wurden.Gets an array of errors accumulated while processing an HTTP request.

AllowAsyncDuringSyncStages

Ruft einen Wert ab oder legt diesen fest, der angibt, ob asynchrone Vorgänge während Teilen der ASP.NET-Anfragenverarbeitung erlaubt sind, wenn sie nicht erwartet werden.Gets or sets a value that indicates whether asynchronous operations are allowed during parts of ASP.NET request processing when they are not expected.

Application

Ruft das HttpApplicationState-Objekt für die aktuelle HTTP-Anforderung ab.Gets the HttpApplicationState object for the current HTTP request.

ApplicationInstance

Ruft das HttpApplication-Objekt für die aktuelle HTTP-Anforderung ab oder legt dieses fest.Gets or sets the HttpApplication object for the current HTTP request.

AsyncPreloadMode

Ruft ein Objekt ab oder legt ein Objekt fest, das die Flags enthält, die den asynchronen Vorablademodus betreffen.Gets or sets an object that contains flags that pertain to asynchronous preload mode.

Cache

Ruft das Cache-Objekt für die aktuelle Anwendungsdomäne ab.Gets the Cache object for the current application domain.

Current

Ruft das HttpContext-Objekt für die aktuelle HTTP-Anforderung ab oder legt dieses fest.Gets or sets the HttpContext object for the current HTTP request.

CurrentHandler

Ruft das IHttpHandler-Objekt ab, das den derzeit ausführenden Handler darstellt.Gets the IHttpHandler object that represents the currently executing handler.

CurrentNotification

Ruft einen RequestNotification-Wert ab, der das HttpApplication-Ereignis angibt, das derzeit verarbeitet wird.Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Error

Ruft ggf. den ersten Fehler ab, der beim Verarbeiten einer HTTP-Anforderung aufgezeichnet wurde.Gets the first error (if any) accumulated during HTTP request processing.

Handler

Ruft das für die Verarbeitung der HTTP-Anforderung verantwortliche IHttpHandler-Objekt ab oder legt dieses fest.Gets or sets the IHttpHandler object responsible for processing the HTTP request.

IsCustomErrorEnabled

Ruft einen Wert ab, der angibt, ob für die aktuelle HTTP-Anforderung benutzerdefinierte Fehler aktiviert sind.Gets a value indicating whether custom errors are enabled for the current HTTP request.

IsDebuggingEnabled

Ruft einen Wert ab, der angibt, ob sich die aktuelle HTTP-Anforderung im Debugmodus befindet.Gets a value indicating whether the current HTTP request is in debug mode.

IsPostNotification

Ruft einen Wert ab, der der aktuelle Verarbeitungspunkt in der ASP.NET-Pipeline ist, gleich nachdem ein HttpApplication-Ereignis die Verarbeitung beendet hat.Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

IsWebSocketRequest

Ruft einen Wert ab, der angibt, ob es sich bei der Anforderung um eine AspNetWebSocket-Anforderung handelt.Gets a value that indicates whether the request is an AspNetWebSocket request.

IsWebSocketRequestUpgrading

Ruft einen Wert ab, der angibt, ob die Verbindung von einer HTTP-Verbindung zu einer AspNetWebSocket-Verbindung aktualisiert wird.Gets a value that indicates whether the connection is upgrading from an HTTP connection to an AspNetWebSocket connection.

Items

Ruft eine Schlüssel-/Wert-Auflistung ab, die während einer HTTP-Anforderung zum Organisieren und Freigeben von Daten zwischen einer IHttpModule-Schnittstelle und einer IHttpHandler-Schnittstelle verwendet werden kann.Gets a key/value collection that can be used to organize and share data between an IHttpModule interface and an IHttpHandler interface during an HTTP request.

PageInstrumentation

Ruft einen Verweis auf die Instanz für Seiteninstrumentierungsdienste für diese Anforderung ab.Gets a reference to the page-instrumentation service instance for this request.

PreviousHandler

Ruft das IHttpHandler-Objekt für den übergeordneten Handler ab.Gets the IHttpHandler object for the parent handler.

Profile

Ruft das ProfileBase-Objekt für das aktuelle Benutzerprofil ab.Gets the ProfileBase object for the current user profile.

Request

Ruft das HttpRequest-Objekt für die aktuelle HTTP-Anforderung ab.Gets the HttpRequest object for the current HTTP request.

Response

Ruft das HttpResponse-Objekt für die aktuelle HTTP-Antwort ab.Gets the HttpResponse object for the current HTTP response.

Server

Ruft das HttpServerUtility-Objekt ab, das die bei der Verarbeitung von Webanforderungen verwendeten Methoden bereitstellt.Gets the HttpServerUtility object that provides methods used in processing Web requests.

Session

Ruft das HttpSessionState-Objekt für die aktuelle HTTP-Anforderung ab.Gets the HttpSessionState object for the current HTTP request.

SkipAuthorization

Ruft einen Wert ab, der angibt, ob das UrlAuthorizationModule-Objekt die Autorisierungsprüfung für die aktuelle Anforderung überspringen soll, oder legt diesen Wert fest.Gets or sets a value that specifies whether the UrlAuthorizationModule object should skip the authorization check for the current request.

ThreadAbortOnTimeout

Ruft einen Wert ab oder legt diesen fest, der angibt, ob die ASP.NET-Laufzeit die Abort() in der Zeichenfolge aufrufen sollte, welche diese Anforderung bedient, wenn die Zeit für diese Anforderung überschritten wird.Gets or sets a value that specifies whether the ASP.NET runtime should call Abort() on the thread that is servicing this request when the request times out.

Timestamp

Ruft den Ausgangstimestamp der aktuellen HTTP-Anforderung ab.Gets the initial timestamp of the current HTTP request.

Trace

Ruft das TraceContext-Objekt für die aktuelle HTTP-Antwort ab.Gets the TraceContext object for the current HTTP response.

User

Ruft die Sicherheitsinformationen für die aktuelle HTTP-Anforderung ab, oder legt diese fest.Gets or sets security information for the current HTTP request.

WebSocketNegotiatedProtocol

Ruft das ausgehandelte Protokoll ab, das vom Server an den Client für eine AspNetWebSocket Verbindung gesendet wurde.Gets the negotiated protocol that was sent from the server to the client for an AspNetWebSocket connection.

WebSocketRequestedProtocols

Ruft die sortierte Liste von Protokollen ab, die vom Client angefordert werden.Gets the ordered list of protocols requested by the client.

Methoden

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

Akzeptiert eine AspNetWebSocket Anforderung unter Verwendung der angegebenen Benutzerfunktion.Accepts an AspNetWebSocket request using the specified user function.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

Akzeptiert eine AspNetWebSocket Anforderung mit dem angegebenen Benutzerfunktions- und Optionenobjekt.Accepts an AspNetWebSocket request using the specified user function and options object.

AddError(Exception)

Fügt der Auflistung der Ausnahmen für die aktuelle HTTP-Anforderung eine Ausnahme hinzu.Adds an exception to the exception collection for the current HTTP request.

AddOnRequestCompleted(Action<HttpContext>)

Löst ein virtuelles Ereignis aus, das eintritt, wenn der HTTP-Teil der Anforderung beendet wird.Raises a virtual event that occurs when the HTTP part of the request is ending.

ClearError()

Löscht alle Fehler für die aktuelle HTTP-Anforderung.Clears all errors for the current HTTP request.

DisposeOnPipelineCompleted(IDisposable)

Aktiviert die Dispose()-Methode eines Objekts, wenn der AspNetWebSocket-Verbindungsteil der Anforderung abgeschlossen ist.Enables an object's Dispose() method to be called when the AspNetWebSocket connection part of this request is completed.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetAppConfig(String)

Gibt die angeforderten Konfigurationsinformationen für die aktuelle Anwendung zurück.Returns requested configuration information for the current application.

GetConfig(String)

Gibt die angeforderten Konfigurationsinformationen für die aktuelle HTTP-Anforderung zurück.Returns requested configuration information for the current HTTP request.

GetGlobalResourceObject(String, String)

Ruft auf der Grundlage der angegebenen ClassKey-Eigenschaft und ResourceKey-Eigenschaft ein Ressourcenobjekt auf Anwendungsebene ab.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

GetGlobalResourceObject(String, String, CultureInfo)

Ruft auf der Grundlage der angegebenen ClassKey-Eigenschaft und ResourceKey-Eigenschaft sowie des angegebenen CultureInfo-Objekts ein Ressourcenobjekt auf Anwendungsebene ab.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, and on the CultureInfo object.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLocalResourceObject(String, String)

Ruft auf der Grundlage der angegebenen VirtualPath-Eigenschaft und ResourceKey-Eigenschaft ein Ressourcenobjekt auf Seitenebene ab.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties.

GetLocalResourceObject(String, String, CultureInfo)

Ruft auf der Grundlage der angegebenen VirtualPath-Eigenschaft und ResourceKey-Eigenschaft sowie des angegebenen CultureInfo-Objekts ein Ressourcenobjekt auf Seitenebene ab.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties, and on the CultureInfo object.

GetSection(String)

Ruft einen angegebenen Konfigurationsabschnitt für die Standardkonfiguration der aktuellen Anwendung ab.Gets a specified configuration section for the current application's default configuration.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
RemapHandler(IHttpHandler)

Ermöglicht es Ihnen, einen Handler für die Anforderung anzugeben.Enables you to specify a handler for the request.

RewritePath(String)

Ändert die URL mit dem angegebenen Pfad.Rewrites the URL using the given path.

RewritePath(String, Boolean)

Ändert die URL mit dem angegebenen Pfad und einem booleschen Wert, der angibt, ob der virtuelle Pfad für die Serverressource geändert wird.Rewrites the URL using the given path and a Boolean value that specifies whether the virtual path for server resources is modified.

RewritePath(String, String, String)

Ändert die URL unter Verwendung des angegebenen Pfads, der Pfadinformationen und der Informationen über die Abfragezeichenfolge.Rewrites the URL by using the given path, path information, and query string information.

RewritePath(String, String, String, Boolean)

Ändert die URL mit dem angegebenen virtuellen Pfad, den angegebenen Pfadinformationen, den angegebenen Zeichenfolgeninformationen und einem booleschen Wert, der angibt, ob der Pfad mit dem Clientdateipfad neu geschrieben wird.Rewrites the URL using the given virtual path, path information, query string information, and a Boolean value that specifies whether the client file path is set to the rewrite path.

SetSessionStateBehavior(SessionStateBehavior)

Legt den Typ des Sitzungszustandsverhaltens fest, der zur Unterstützung von HTTP-Anforderungen erforderlich ist.Sets the type of session state behavior that is required in order to support an HTTP request.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IServiceProvider.GetService(Type)

Gibt ein Objekt für den aktuellen Diensttyp zurück.Returns an object for the current service type.

Gilt für:

Siehe auch