HttpContext Clase

Definición

Encapsula toda la información específica de HTTP acerca de una solicitud HTTP individual.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
Herencia
HttpContext
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso y mostrar las propiedades del objeto HttpContext.The following example demonstrates how to access and display properties of the HttpContext object. Se tiene acceso al contexto de la solicitud HTTP actual utilizando la propiedad Context del objeto Page.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>

Comentarios

A las clases que heredan las interfaces IHttpModule y IHttpHandler se les proporciona una referencia a un objeto HttpContext para la solicitud HTTP actual.Classes that inherit the IHttpModule and IHttpHandler interfaces are provided a reference to an HttpContext object for the current HTTP request. El objeto proporciona acceso a las propiedades intrínsecas Request, Responsey Server de la solicitud.The object provides access to the intrinsic Request, Response, and Server properties for the request.

Importante

Este objeto está listo para la recolección de elementos no utilizados cuando se completa el HttpRequest.This object is ready for garbage collection when the HttpRequest is completed. Su uso después de que se complete la solicitud podría provocar un comportamiento indefinido, como un NullReferenceException.Its usage after the request completes could lead to undefined behavior, such as a NullReferenceException.

Este objeto solo está disponible en el subproceso controlado por ASP.NET.This object is only available in the thread controlled by ASP.NET. El uso de subprocesos en segundo plano podría provocar un comportamiento indefinido.Usage in background threads could lead to undefined behavior.

Constructores

HttpContext(HttpRequest, HttpResponse)

Inicializa una nueva instancia de la clase HttpContext usando los objetos de solicitud y respuesta especificados.Initializes a new instance of the HttpContext class by using the specified request and response objects.

HttpContext(HttpWorkerRequest)

Inicializa una nueva instancia de la clase HttpContext que usa el objeto de solicitud de trabajo especificado.Initializes a new instance of the HttpContext class that uses the specified worker-request object.

Propiedades

AllErrors

Obtiene una matriz de errores acumulados al procesar una solicitud HTTP.Gets an array of errors accumulated while processing an HTTP request.

AllowAsyncDuringSyncStages

Obtiene o establece un valor que indica si las operaciones asincrónicas están permitidas durante partes del procesamiento de la solicitud ASP.NET en que no se esperan.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

Obtiene el objeto HttpApplicationState de la solicitud HTTP actual.Gets the HttpApplicationState object for the current HTTP request.

ApplicationInstance

Obtiene o establece el objeto HttpApplication de la solicitud HTTP actual.Gets or sets the HttpApplication object for the current HTTP request.

AsyncPreloadMode

Obtiene o establece un objeto que contiene marcas que pertenecen al modo de precarga asincrónico.Gets or sets an object that contains flags that pertain to asynchronous preload mode.

Cache

Obtiene el objeto Cache del dominio de aplicación actual.Gets the Cache object for the current application domain.

Current

Obtiene o establece el objeto HttpContext de la solicitud HTTP actual.Gets or sets the HttpContext object for the current HTTP request.

CurrentHandler

Obtiene el objeto IHttpHandler que representa el controlador que se ejecuta actualmente.Gets the IHttpHandler object that represents the currently executing handler.

CurrentNotification

Obtiene un valor de RequestNotification que indica el evento HttpApplication actual que se está procesando.Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Error

Obtiene el primer error (si existe) acumulado durante el procesamiento de la solicitud HTTP.Gets the first error (if any) accumulated during HTTP request processing.

Handler

Obtiene o establece el objeto IHttpHandler responsable del procesamiento de la solicitud HTTP actual.Gets or sets the IHttpHandler object responsible for processing the HTTP request.

IsCustomErrorEnabled

Obtiene un valor que indica si se han habilitado errores personalizados para la actual solicitud HTTP.Gets a value indicating whether custom errors are enabled for the current HTTP request.

IsDebuggingEnabled

Obtiene un valor que indica si la actual solicitud HTTP está en modo de depuración.Gets a value indicating whether the current HTTP request is in debug mode.

IsPostNotification

Obtiene un valor que es el punto de procesamiento actual en la canalización de ASP.NET justo después de que un evento de HttpApplication haya finalizado el procesamiento.Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

IsWebSocketRequest

Obtiene un valor que indica si la solicitud es un AspNetWebSocket.Gets a value that indicates whether the request is an AspNetWebSocket request.

IsWebSocketRequestUpgrading

Obtiene un valor que indica si la conexión se está actualizando de una conexión HTTP a una conexión AspNetWebSocket.Gets a value that indicates whether the connection is upgrading from an HTTP connection to an AspNetWebSocket connection.

Items

Obtiene una colección de clave/valor que permite organizar y compartir datos entre una interfaz IHttpModule y una interfaz IHttpHandler durante una solicitud HTTP.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

Obtiene una referencia a la instancia de servicio de instrumentación de página para esta solicitud.Gets a reference to the page-instrumentation service instance for this request.

PreviousHandler

Obtiene el objeto IHttpHandler para el controlador primario.Gets the IHttpHandler object for the parent handler.

Profile

Obtiene el objeto ProfileBase del perfil de usuario actual.Gets the ProfileBase object for the current user profile.

Request

Obtiene el objeto HttpRequest de la solicitud HTTP actual.Gets the HttpRequest object for the current HTTP request.

Response

Obtiene el objeto HttpResponse de la actual respuesta HTTP.Gets the HttpResponse object for the current HTTP response.

Server

Obtiene el objeto HttpServerUtility que proporciona métodos que se utilizan en el procesamiento de solicitudes Web.Gets the HttpServerUtility object that provides methods used in processing Web requests.

Session

Obtiene el objeto HttpSessionState de la solicitud HTTP actual.Gets the HttpSessionState object for the current HTTP request.

SkipAuthorization

Obtiene o establece un valor que especifica si el objeto UrlAuthorizationModule debe omitir la comprobación de autorización para la actual solicitud.Gets or sets a value that specifies whether the UrlAuthorizationModule object should skip the authorization check for the current request.

ThreadAbortOnTimeout

Obtiene o establece un valor que especifica si el tiempo de ejecución de ASP.NET debe llamar a Abort() en el subproceso que está manteniendo esta solicitud cuando la solicitud agota su tiempo de espera.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

Obtiene la marca de tiempo inicial de la actual solicitud HTTP.Gets the initial timestamp of the current HTTP request.

Trace

Obtiene el objeto TraceContext de la actual respuesta HTTP.Gets the TraceContext object for the current HTTP response.

User

Obtiene o establece información de seguridad para la actual solicitud HTTP.Gets or sets security information for the current HTTP request.

WebSocketNegotiatedProtocol

Obtiene el protocolo negociado que se envió del servidor al cliente para una conexión de AspNetWebSocket .Gets the negotiated protocol that was sent from the server to the client for an AspNetWebSocket connection.

WebSocketRequestedProtocols

Obtiene la lista ordenada de protocolos solicitados por el cliente.Gets the ordered list of protocols requested by the client.

Métodos

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

Acepta una solicitud de AspNetWebSocket mediante la función especificada del usuario.Accepts an AspNetWebSocket request using the specified user function.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

Acepta una solicitud de AspNetWebSocket mediante la función de usuario y el objeto de opciones especificados.Accepts an AspNetWebSocket request using the specified user function and options object.

AddError(Exception)

Agrega una excepción a la colección de excepciones de la solicitud HTTP actual.Adds an exception to the exception collection for the current HTTP request.

AddOnRequestCompleted(Action<HttpContext>)

Genera un evento virtual que se produce cuando finaliza la parte HTTP de la solicitud.Raises a virtual event that occurs when the HTTP part of the request is ending.

ClearError()

Borra todos los errores de la solicitud HTTP actual.Clears all errors for the current HTTP request.

DisposeOnPipelineCompleted(IDisposable)

Habilita el método Dispose() de un objeto al que se llama cuando la parte de la conexión de AspNetWebSocket de esta solicitud se completa.Enables an object's Dispose() method to be called when the AspNetWebSocket connection part of this request is completed.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetAppConfig(String)

Devuelve la información de configuración solicitada de la actual aplicación.Returns requested configuration information for the current application.

GetConfig(String)

Devuelve la información de configuración solicitada de la actual solicitud HTTP.Returns requested configuration information for the current HTTP request.

GetGlobalResourceObject(String, String)

Obtiene un objeto de recurso de aplicación basado en las propiedades ClassKey y ResourceKey especificadas.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

GetGlobalResourceObject(String, String, CultureInfo)

Obtiene un objeto de recurso de aplicación basado en las propiedades ClassKey y ResourceKey y el objeto CultureInfo especificados.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, and on the CultureInfo object.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLocalResourceObject(String, String)

Obtiene un objeto de recurso de página basado en las propiedades VirtualPath y ResourceKey especificadas.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties.

GetLocalResourceObject(String, String, CultureInfo)

Obtiene un objeto de recurso de página basado en las propiedades VirtualPath y ResourceKey y en el objeto CultureInfo especificados.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties, and on the CultureInfo object.

GetSection(String)

Obtiene una sección de configuración especificada para la configuración predeterminada de la aplicación actual.Gets a specified configuration section for the current application's default configuration.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
RemapHandler(IHttpHandler)

Permite especificar un controlador para la solicitud.Enables you to specify a handler for the request.

RewritePath(String)

Rescribe la dirección URL mediante la ruta de acceso determinada.Rewrites the URL using the given path.

RewritePath(String, Boolean)

Escribe de nuevo la dirección URL mediante la ruta de acceso determinada y un valor Boolean que especifica si se modifica la ruta de acceso virtual para los recursos del servidor.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)

Vuelve a escribir la dirección URL utilizando la ruta de acceso, la información de ruta de acceso y la información de cadena de consulta especificadas.Rewrites the URL by using the given path, path information, and query string information.

RewritePath(String, String, String, Boolean)

Rescribe la dirección URL mediante la ruta de acceso virtual determinada, la información de ruta de acceso, la información de cadena de consulta y un valor booleano que especifica si la ruta de acceso del archivo del cliente se establece en la ruta de acceso de reescritura.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)

Establece el tipo de comportamiento de estado de sesión que se requiere para admitir una solicitud HTTP.Sets the type of session state behavior that is required in order to support an HTTP request.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IServiceProvider.GetService(Type)

Devuelve un objeto para el tipo de servicio actual.Returns an object for the current service type.

Se aplica a

Consulte también: