Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase HttpContext

 

Publicado: octubre de 2016

Encapsula toda la información específica de HTTP acerca de una solicitud HTTP individual.

Espacio de nombres:   System.Web
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Web.HttpContext

public sealed class HttpContext : IServiceProvider

NombreDescripción
System_CAPS_pubmethodHttpContext(HttpRequest, HttpResponse)

Inicializa una nueva instancia de la clase HttpContext usando los objetos de solicitud y respuesta especificados.

System_CAPS_pubmethodHttpContext(HttpWorkerRequest)

Inicializa una nueva instancia de la clase HttpContext que usa el objeto de solicitud de trabajo especificado.

NombreDescripción
System_CAPS_pubpropertyAllErrors

Obtiene una matriz de errores acumulados al procesar una solicitud HTTP.

System_CAPS_pubpropertyAllowAsyncDuringSyncStages

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.

System_CAPS_pubpropertyApplication

Obtiene el objeto HttpApplicationState de la solicitud HTTP actual.

System_CAPS_pubpropertyApplicationInstance

Obtiene o establece el objeto HttpApplication de la solicitud HTTP actual.

System_CAPS_pubpropertyAsyncPreloadMode

Obtiene o establece un objeto que contiene marcas que pertenecen al modo de precarga asincrónico.

System_CAPS_pubpropertyCache

Obtiene el objeto Cache del dominio de aplicación actual.

System_CAPS_pubpropertySystem_CAPS_staticCurrent

Obtiene o establece el objeto HttpContext de la solicitud HTTP actual.

System_CAPS_pubpropertyCurrentHandler

Obtiene el objeto IHttpHandler que representa el controlador que se ejecuta actualmente.

System_CAPS_pubpropertyCurrentNotification

Obtiene un valor de RequestNotification que indica el evento HttpApplication actual que se está procesando.

System_CAPS_pubpropertyError

Obtiene el primer error (si existe) acumulado durante el procesamiento de la solicitud HTTP.

System_CAPS_pubpropertyHandler

Obtiene o establece el objeto IHttpHandler responsable del procesamiento de la solicitud HTTP actual.

System_CAPS_pubpropertyIsCustomErrorEnabled

Obtiene un valor que indica si se habilitaron errores personalizados para la solicitud HTTP actual.

System_CAPS_pubpropertyIsDebuggingEnabled

Obtiene un valor que indica si la solicitud HTTP actual está en modo de depuración.

System_CAPS_pubpropertyIsPostNotification

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.

System_CAPS_pubpropertyIsWebSocketRequest

Obtiene un valor que indica si es una solicitud AspNetWebSocket.

System_CAPS_pubpropertyIsWebSocketRequestUpgrading

Obtiene un valor que indica si la conexión se está actualizando de una conexión HTTP a una conexión AspNetWebSocket.

System_CAPS_pubpropertyItems

Obtiene una colección de pares clave/valor que permite organizar y compartir datos entre una interfaz IHttpModule y una interfaz IHttpHandler durante una solicitud HTTP.

System_CAPS_pubpropertyPageInstrumentation

Obtiene una referencia a la instancia del servicio de instrumentación de página para esta solicitud.

System_CAPS_pubpropertyPreviousHandler

Obtiene el objeto IHttpHandler para el controlador primario.

System_CAPS_pubpropertyProfile

Obtiene el objeto ProfileBase del perfil de usuario actual.

System_CAPS_pubpropertyRequest

Obtiene el objeto HttpRequest de la solicitud HTTP actual.

System_CAPS_pubpropertyResponse

Obtiene el objeto HttpResponse de la respuesta HTTP actual.

System_CAPS_pubpropertyServer

Obtiene el objeto HttpServerUtility que proporciona los métodos que se usan en el procesamiento de solicitudes web.

System_CAPS_pubpropertySession

Obtiene el objeto HttpSessionState de la solicitud HTTP actual.

System_CAPS_pubpropertySkipAuthorization

Obtiene o establece un valor que especifica si el objeto UrlAuthorizationModule debe omitir la comprobación de autorización para la solicitud actual.

System_CAPS_pubpropertyThreadAbortOnTimeout

Obtiene o establece un valor que especifica si el tiempo de ejecución de ASP.NET debe llamar a Thread.Abort en el subproceso que atiende esta solicitud cuando la solicitud agota su tiempo de espera.

System_CAPS_pubpropertyTimestamp

Obtiene la marca de tiempo inicial de la solicitud HTTP actual.

System_CAPS_pubpropertyTrace

Obtiene el objeto TraceContext de la respuesta HTTP actual.

System_CAPS_pubpropertyUser

Obtiene o establece información de seguridad de la solicitud HTTP actual.

System_CAPS_pubpropertyWebSocketNegotiatedProtocol

Obtiene el protocolo negociado que se envió desde el servidor al cliente para una conexión de AspNetWebSocket.

System_CAPS_pubpropertyWebSocketRequestedProtocols

Obtiene la lista ordenada de los protocolos solicitados por el cliente.

NombreDescripción
System_CAPS_pubmethodAcceptWebSocketRequest(Func<AspNetWebSocketContext, Task>)

Acepta una solicitud AspNetWebSocket usando la función de usuario especificada.

System_CAPS_pubmethodAcceptWebSocketRequest(Func<AspNetWebSocketContext, Task>, AspNetWebSocketOptions)

Acepta una solicitud AspNetWebSocket usando la función de usuario y el objeto de opciones especificados.

System_CAPS_pubmethodAddError(Exception)

Agrega una excepción a la colección de excepciones de la solicitud HTTP actual.

System_CAPS_pubmethodAddOnRequestCompleted(Action<HttpContext>)

Genera un evento virtual que se produce cuando finaliza la parte HTTP de la solicitud.

System_CAPS_pubmethodClearError()

Borra todos los errores de la solicitud HTTP actual.

System_CAPS_pubmethodDisposeOnPipelineCompleted(IDisposable)

Permite llamar al método Dispose de un objeto cuando se complete la parte de conexión de AspNetWebSocket de esta solicitud.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetAppConfig(String)

Obsoleto. Devuelve la información de configuración solicitada para la aplicación actual.

System_CAPS_pubmethodGetConfig(String)

Obsoleto. Devuelve la información de configuración solicitada para la solicitud HTTP actual.

System_CAPS_pubmethodSystem_CAPS_staticGetGlobalResourceObject(String, String)

Obtiene un objeto de recurso de nivel de aplicación basado en las propiedades ClassKey y ResourceKey especificadas.

System_CAPS_pubmethodSystem_CAPS_staticGetGlobalResourceObject(String, String, CultureInfo)

Obtiene un objeto de recurso de nivel de aplicación basado en las propiedades ClassKey y ResourceKey especificadas, y en el objeto CultureInfo.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetLocalResourceObject(String, String)

Obtiene un objeto de recurso de nivel de página basado en las propiedades VirtualPath y ResourceKey especificadas.

System_CAPS_pubmethodSystem_CAPS_staticGetLocalResourceObject(String, String, CultureInfo)

Obtiene un objeto de recurso de nivel de página basado en las propiedades VirtualPath y ResourceKey especificadas y en el objeto CultureInfo.

System_CAPS_pubmethodGetSection(String)

Obtiene una sección de configuración especificada para la configuración predeterminada de la aplicación actual.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodRemapHandler(IHttpHandler)

Permite especificar un controlador para la solicitud.

System_CAPS_pubmethodRewritePath(String)

Reescribe la dirección URL usando la ruta de acceso dada.

System_CAPS_pubmethodRewritePath(String, Boolean)

Reescribe la dirección URL usando la ruta de acceso dada y un valor booleano que especifica si se modifica la ruta de acceso virtual a los recursos del servidor.

System_CAPS_pubmethodRewritePath(String, String, String)

Reescribe la dirección URL usando la ruta de acceso, la información de la ruta de acceso y la información de la cadena de consulta especificadas.

System_CAPS_pubmethodRewritePath(String, String, String, Boolean)

Reescribe la dirección URL usando la ruta de acceso virtual dada, la información de la ruta de acceso, la información la 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.

System_CAPS_pubmethodSetSessionStateBehavior(SessionStateBehavior)

Establece el tipo de comportamiento de estado de sesión que se requiere para admitir una solicitud HTTP.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIServiceProvider.GetService(Type)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un objeto para el tipo de servicio actual.

Classes that inherit the T:System.Web.IHttpModule and T:System.Web.IHttpHandler interfaces are provided a reference to an T:System.Web.HttpContext object for the current HTTP request. The object provides access to the intrinsic P:System.Web.HttpContext.Request, P:System.Web.HttpContext.Response, and P:System.Web.HttpContext.Server properties for the request.

A Visual Studio Web site project with source code is available to accompany this topic: Downloadhttp://go.microsoft.com/fwlink/?LinkId=192422.

The following example demonstrates how to access and display properties of the T:System.Web.HttpContext object. The context of the current HTTP request is accessed by using the P:System.Web.UI.Page.Context property of the T:System.Web.UI.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>

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: