HttpContext Classe

Definição

Encapsula todas as informações específicas de HTTP sobre uma solicitação 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
Herança
HttpContext
Implementações

Exemplos

O exemplo a seguir demonstra como acessar e exibir as propriedades do HttpContext objeto.The following example demonstrates how to access and display properties of the HttpContext object. O contexto da solicitação HTTP atual é acessado usando a Context Propriedade do Page objeto.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>

Comentários

Classes que herdam IHttpModule as IHttpHandler interfaces e são fornecidas uma referência a um HttpContext objeto para a solicitação HTTP atual.Classes that inherit the IHttpModule and IHttpHandler interfaces are provided a reference to an HttpContext object for the current HTTP request. O objeto fornece acesso às propriedades intrínsecas Request , Response e Server para a solicitação.The object provides access to the intrinsic Request, Response, and Server properties for the request.

Importante

Este objeto está pronto para coleta de lixo quando o HttpRequest é concluído.This object is ready for garbage collection when the HttpRequest is completed. Seu uso após a solicitação ser concluída pode levar a um comportamento indefinido, como um NullReferenceException .Its usage after the request completes could lead to undefined behavior, such as a NullReferenceException.

Esse objeto só está disponível no thread controlado por ASP.NET.This object is only available in the thread controlled by ASP.NET. O uso em threads em segundo plano pode levar a um comportamento indefinido.Usage in background threads could lead to undefined behavior.

Construtores

HttpContext(HttpRequest, HttpResponse)

Inicializa uma nova instância da classe HttpContext usando a solicitação e os objetos de resposta especificados.Initializes a new instance of the HttpContext class by using the specified request and response objects.

HttpContext(HttpWorkerRequest)

Inicializa uma nova instância da classe HttpContext que usa o objeto de solicitação de trabalho especificado.Initializes a new instance of the HttpContext class that uses the specified worker-request object.

Propriedades

AllErrors

Obtém uma matriz de erros acumulados durante o processamento de uma solicitação HTTP.Gets an array of errors accumulated while processing an HTTP request.

AllowAsyncDuringSyncStages

Obtém ou define um valor que indica se as operações assíncronas são permitidas durante partes do processamento da solicitação ASP.NET quando elas não são esperadas.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

Obtém o objeto HttpApplicationState para a solicitação HTTP atual.Gets the HttpApplicationState object for the current HTTP request.

ApplicationInstance

Obtém ou define o objeto HttpApplication para a atual solicitação HTTP.Gets or sets the HttpApplication object for the current HTTP request.

AsyncPreloadMode

Obtém ou define um objeto que contém sinalizadores que pertencem ao modo de pré-carregamento assíncrono.Gets or sets an object that contains flags that pertain to asynchronous preload mode.

Cache

Obtém o objeto Cache para o domínio do aplicativo atual.Gets the Cache object for the current application domain.

Current

Obtém ou define o objeto HttpContext para a atual solicitação HTTP.Gets or sets the HttpContext object for the current HTTP request.

CurrentHandler

Obtém o objeto IHttpHandler que representa o manipulador atualmente em execução.Gets the IHttpHandler object that represents the currently executing handler.

CurrentNotification

Obtém um valor RequestNotification que indica o evento HttpApplication atual que está sendo processado.Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Error

Obtém o primeiro erro (se houver) acumulado durante o processamento da solicitação HTTP.Gets the first error (if any) accumulated during HTTP request processing.

Handler

Obtém ou define o objeto IHttpHandler responsável por processar a solicitação HTTP.Gets or sets the IHttpHandler object responsible for processing the HTTP request.

IsCustomErrorEnabled

Obtém um valor que indica se os erros personalizados estão habilitados para a solicitação HTTP atual.Gets a value indicating whether custom errors are enabled for the current HTTP request.

IsDebuggingEnabled

Obtém um valor que indica se a solicitação HTTP atual está no modo de depuração.Gets a value indicating whether the current HTTP request is in debug mode.

IsPostNotification

Obtém um valor que é o ponto de processamento atual no pipeline do ASP.NET logo após a conclusão do processamento de um evento HttpApplication.Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

IsWebSocketRequest

Obtém um valor que indica se a solicitação é uma solicitação AspNetWebSocket.Gets a value that indicates whether the request is an AspNetWebSocket request.

IsWebSocketRequestUpgrading

Obtém um valor que indica se a conexão está atualizando de uma conexão HTTP para uma conexão AspNetWebSocket.Gets a value that indicates whether the connection is upgrading from an HTTP connection to an AspNetWebSocket connection.

Items

Obtém uma coleção de chave/valor que pode ser usada para organizar e compartilhar dados entre uma interface IHttpModule e uma interface IHttpHandler durante uma solicitação 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

Obtém uma referência à instância de serviço de instrumentação de página para essa solicitação.Gets a reference to the page-instrumentation service instance for this request.

PreviousHandler

Obtém o objeto IHttpHandler para o manipulador pai.Gets the IHttpHandler object for the parent handler.

Profile

Obtém o objeto ProfileBase para o perfil do usuário atual.Gets the ProfileBase object for the current user profile.

Request

Obtém o objeto HttpRequest para a solicitação HTTP atual.Gets the HttpRequest object for the current HTTP request.

Response

Obtém o objeto HttpResponse para a resposta HTTP atual.Gets the HttpResponse object for the current HTTP response.

Server

Obtém o objeto HttpServerUtility que fornece métodos usados no processamento de solicitações da Web.Gets the HttpServerUtility object that provides methods used in processing Web requests.

Session

Obtém o objeto HttpSessionState para a solicitação HTTP atual.Gets the HttpSessionState object for the current HTTP request.

SkipAuthorization

Obtém ou define um valor que especifica se o objeto UrlAuthorizationModule deve ignorar a verificação de autorização da solicitação atual.Gets or sets a value that specifies whether the UrlAuthorizationModule object should skip the authorization check for the current request.

ThreadAbortOnTimeout

Obtém ou define um valor que especifica se o runtime do ASP.NET deve chamar Abort() no thread que está atendendo a essa solicitação quando a solicitação expira.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

Obtém o carimbo de data/hora inicial da solicitação HTTP atual.Gets the initial timestamp of the current HTTP request.

Trace

Obtém o objeto TraceContext para a resposta HTTP atual.Gets the TraceContext object for the current HTTP response.

User

Obtém ou define informações de segurança para a solicitação HTTP atual.Gets or sets security information for the current HTTP request.

WebSocketNegotiatedProtocol

Obtém o protocolo negociado que foi enviado do servidor para o cliente para uma conexão AspNetWebSocket.Gets the negotiated protocol that was sent from the server to the client for an AspNetWebSocket connection.

WebSocketRequestedProtocols

Obtém a lista ordenada de protocolos solicitados pelo cliente.Gets the ordered list of protocols requested by the client.

Métodos

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

Aceita uma solicitação AspNetWebSocket usando a função de usuário especificada.Accepts an AspNetWebSocket request using the specified user function.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

Aceita uma solicitação AspNetWebSocket usando a função de usuário e o objeto de opções especificados.Accepts an AspNetWebSocket request using the specified user function and options object.

AddError(Exception)

Adiciona uma exceção à coleção de exceções da solicitação HTTP atual.Adds an exception to the exception collection for the current HTTP request.

AddOnRequestCompleted(Action<HttpContext>)

Aciona um evento virtual que ocorre quando a parte HTTP da solicitação está terminando.Raises a virtual event that occurs when the HTTP part of the request is ending.

ClearError()

Limpa todos os erros da solicitação HTTP atual.Clears all errors for the current HTTP request.

DisposeOnPipelineCompleted(IDisposable)

Permite que o método Dispose() de um objeto seja chamado quando a parte de conexão AspNetWebSocket dessa solicitação é concluída.Enables an object's Dispose() method to be called when the AspNetWebSocket connection part of this request is completed.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetAppConfig(String)
Obsoleto.

Retorna informações de configuração solicitadas para o aplicativo atual.Returns requested configuration information for the current application.

GetConfig(String)
Obsoleto.

Retorna as informações de configuração solicitadas para a solicitação HTTP atual.Returns requested configuration information for the current HTTP request.

GetGlobalResourceObject(String, String)

Obtém um objeto de recurso no nível de aplicativo baseado nas propriedades ClassKey e ResourceKey especificadas.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

GetGlobalResourceObject(String, String, CultureInfo)

Obtém um objeto de recurso no nível do aplicativo baseado nas propriedades ClassKey e ResourceKey especificadas e no objeto CultureInfo.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, and on the CultureInfo object.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLocalResourceObject(String, String)

Obtém um objeto de recurso de nível de página com base nas propriedades VirtualPath e ResourceKey especificadas.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties.

GetLocalResourceObject(String, String, CultureInfo)

Obtém um objeto de recurso no nível da página com base nas propriedades VirtualPath e ResourceKey especificadas e no objeto CultureInfo.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties, and on the CultureInfo object.

GetSection(String)

Obtém uma seção de configuração especificada para a configuração padrão do aplicativo atual.Gets a specified configuration section for the current application's default configuration.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
RemapHandler(IHttpHandler)

Permite que você especifique um manipulador para a solicitação.Enables you to specify a handler for the request.

RewritePath(String)

Regrava a URL usando o caminho fornecido.Rewrites the URL using the given path.

RewritePath(String, Boolean)

Regrava a URL usando o caminho especificado e um valor booliano que especifica se o caminho virtual para recursos de servidor é modificado.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)

Regrava a URL usando o caminho, as informações de caminho e as informações de cadeia de caracteres de consulta especificados.Rewrites the URL by using the given path, path information, and query string information.

RewritePath(String, String, String, Boolean)

Regrava a URL usando o caminho virtual fornecido, informações de caminho, informações de cadeia de caracteres de consulta e um valor booliano que especifica se o caminho do arquivo de cliente é definido como o caminho de regravação.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)

Define o tipo de comportamento de estado de sessão que é necessário para dar suporte a uma solicitação HTTP.Sets the type of session state behavior that is required in order to support an HTTP request.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IServiceProvider.GetService(Type)

Retorna um objeto para o tipo de serviço atual.Returns an object for the current service type.

Aplica-se a

Confira também