HttpContext HttpContext HttpContext HttpContext Class

정의

개별 HTTP 요청에 대한 HTTP 관련 정보를 모두 캡슐화합니다.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
상속
HttpContextHttpContextHttpContextHttpContext
구현

예제

다음 예제에는 액세스의 속성을 표시 하는 방법을 보여 줍니다.는 HttpContext 개체입니다.The following example demonstrates how to access and display properties of the HttpContext object. 현재 HTTP 요청 컨텍스트를 사용 하 여 액세스를 Context 의 속성을 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>

설명

상속 된 클래스는 IHttpModule 하 고 IHttpHandler 인터페이스에 대 한 참조가 제공 됩니다는 HttpContext 현재 HTTP 요청에 대 한 개체입니다.Classes that inherit the IHttpModule and IHttpHandler interfaces are provided a reference to an HttpContext object for the current HTTP request. 내장 함수에 대 한 액세스를 제공 하는 개체 Request하십시오 Response, 및 Server 요청에 대 한 속성입니다.The object provides access to the intrinsic Request, Response, and Server properties for the request.

중요

이 개체는 가비지 수집에 대 한 준비 때는 HttpRequest 완료 됩니다.This object is ready for garbage collection when the HttpRequest is completed. 요청 완료 후 용도 같은 정의 되지 않은 동작이 발생할 수 있습니다는 NullReferenceException합니다.Its usage after the request completes could lead to undefined behavior, such as a NullReferenceException.

이 개체는만 ASP.NET에서 제어 하는 스레드에서 사용할 수 있습니다.This object is only available in the thread controlled by ASP.NET. 백그라운드 스레드에서 사용은 정의 되지 않은 동작이 발생할 수 있습니다.Usage in background threads could lead to undefined behavior.

생성자

HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse)

지정된 요청과 응답 개체를 사용하여 HttpContext 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the HttpContext class by using the specified request and response objects.

HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest)

지정된 작업자 요청 개체를 사용하는 HttpContext 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the HttpContext class that uses the specified worker-request object.

속성

AllErrors AllErrors AllErrors AllErrors

HTTP 요청을 처리하는 동안 누적된 오류의 배열을 가져옵니다.Gets an array of errors accumulated while processing an HTTP request.

AllowAsyncDuringSyncStages AllowAsyncDuringSyncStages AllowAsyncDuringSyncStages AllowAsyncDuringSyncStages

비동기 작업을 예상하지 못한 경우 ASP.NET 요청의 일부를 처리하는 중에 비동기 작업이 허용되는지 여부를 나타내는 값을 가져오거나 설정합니다.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 Application Application Application

현재 HTTP 요청에 대한 HttpApplicationState 개체를 가져옵니다.Gets the HttpApplicationState object for the current HTTP request.

ApplicationInstance ApplicationInstance ApplicationInstance ApplicationInstance

현재 HTTP 요청에 대한 HttpApplication 개체를 가져오거나 설정합니다.Gets or sets the HttpApplication object for the current HTTP request.

AsyncPreloadMode AsyncPreloadMode AsyncPreloadMode AsyncPreloadMode

비동기 미리 로드 모드와 관련된 플래그를 포함하는 개체를 가져오거나 설정합니다.Gets or sets an object that contains flags that pertain to asynchronous preload mode.

Cache Cache Cache Cache

현재 애플리케이션 도메인에 대한 Cache 개체를 가져옵니다.Gets the Cache object for the current application domain.

Current Current Current Current

현재 HTTP 요청에 대한 HttpContext 개체를 가져오거나 설정합니다.Gets or sets the HttpContext object for the current HTTP request.

CurrentHandler CurrentHandler CurrentHandler CurrentHandler

현재 실행 중인 처리기를 나타내는 IHttpHandler 개체를 가져옵니다.Gets the IHttpHandler object that represents the currently executing handler.

CurrentNotification CurrentNotification CurrentNotification CurrentNotification

현재 처리 중인 HttpApplication 이벤트를 나타내는 RequestNotification 값을 가져옵니다.Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Error Error Error Error

HTTP 요청을 처리하는 동안 누적된 오류가 있으면 첫 번째 오류를 가져옵니다.Gets the first error (if any) accumulated during HTTP request processing.

Handler Handler Handler Handler

HTTP 요청을 처리하는 IHttpHandler 개체를 가져오거나 설정합니다.Gets or sets the IHttpHandler object responsible for processing the HTTP request.

IsCustomErrorEnabled IsCustomErrorEnabled IsCustomErrorEnabled IsCustomErrorEnabled

현재 HTTP 요청에 대해 사용자 지정 오류를 사용할 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether custom errors are enabled for the current HTTP request.

IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled

현재 HTTP 요청이 디버그 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the current HTTP request is in debug mode.

IsPostNotification IsPostNotification IsPostNotification IsPostNotification

HttpApplication 이벤트가 처리를 완료한 직후 ASP.NET 파이프라인의 현재 처리 지점인 값을 가져옵니다.Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest

요청에 AspNetWebSocket 요청이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the request is an AspNetWebSocket request.

IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading

연결이 HTTP 연결에서 AspNetWebSocket 연결로 업그레이드되고 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the connection is upgrading from an HTTP connection to an AspNetWebSocket connection.

Items Items Items Items

HTTP 요청을 수행하는 동안 IHttpModule 인터페이스와 IHttpHandler 인터페이스 간에 데이터를 구성하고 공유하는 데 사용할 수 있는 키/값 컬렉션을 가져옵니다.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 PageInstrumentation PageInstrumentation PageInstrumentation

이 요청에 대한 페이지 계측 서비스 인스턴스에 대한 참조를 가져옵니다.Gets a reference to the page-instrumentation service instance for this request.

PreviousHandler PreviousHandler PreviousHandler PreviousHandler

부모 처리기에 대한 IHttpHandler 개체를 가져옵니다.Gets the IHttpHandler object for the parent handler.

Profile Profile Profile Profile

현재 사용자 프로필에 대한 ProfileBase 개체를 가져옵니다.Gets the ProfileBase object for the current user profile.

Request Request Request Request

현재 HTTP 요청에 대한 HttpRequest 개체를 가져옵니다.Gets the HttpRequest object for the current HTTP request.

Response Response Response Response

현재 HTTP 응답에 대한 HttpResponse 개체를 가져옵니다.Gets the HttpResponse object for the current HTTP response.

Server Server Server Server

처리하고 있는 웹 요청에 사용되는 메서드를 제공하는 HttpServerUtility 개체를 가져옵니다.Gets the HttpServerUtility object that provides methods used in processing Web requests.

Session Session Session Session

현재 HTTP 요청에 대한 HttpSessionState 개체를 가져옵니다.Gets the HttpSessionState object for the current HTTP request.

SkipAuthorization SkipAuthorization SkipAuthorization SkipAuthorization

UrlAuthorizationModule 개체가 현재 요청에 대한 인증 확인을 건너뛰어야 하는지 여부를 지정하는 값을 가져오거나 설정합니다.Gets or sets a value that specifies whether the UrlAuthorizationModule object should skip the authorization check for the current request.

ThreadAbortOnTimeout ThreadAbortOnTimeout ThreadAbortOnTimeout ThreadAbortOnTimeout

요청 시간이 경과될 경우 이 요청을 서비스 중인 스레드에서 ASP.NET 런타임이 Abort()를 호출해야 하는지 여부를 지정하는 값을 가져오거나 설정합니다.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 Timestamp Timestamp Timestamp

현재 HTTP 요청의 초기 타임스탬프를 가져옵니다.Gets the initial timestamp of the current HTTP request.

Trace Trace Trace Trace

현재 HTTP 응답에 대한 TraceContext 개체를 가져옵니다.Gets the TraceContext object for the current HTTP response.

User User User User

현재 HTTP 요청에 대한 보안 정보를 가져오거나 설정합니다.Gets or sets security information for the current HTTP request.

WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol

AspNetWebSocket 연결을 위해 서버에서 클라이언트로 전송된 협상된 프로토콜을 가져옵니다.Gets the negotiated protocol that was sent from the server to the client for an AspNetWebSocket connection.

WebSocketRequestedProtocols WebSocketRequestedProtocols WebSocketRequestedProtocols WebSocketRequestedProtocols

클라이언트에서 요청한 프로토콜의 순서 있는 목록을 가져옵니다.Gets the ordered list of protocols requested by the client.

메서드

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

지정된 사용자 함수를 사용하는 AspNetWebSocket 요청을 허용합니다.Accepts an AspNetWebSocket request using the specified user function.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

지정된 사용자 함수 및 옵션 개체를 사용하는 AspNetWebSocket 요청을 허용합니다.Accepts an AspNetWebSocket request using the specified user function and options object.

AddError(Exception) AddError(Exception) AddError(Exception) AddError(Exception)

현재 HTTP 요청에 대한 예외 컬렉션에 예외를 추가합니다.Adds an exception to the exception collection for the current HTTP request.

AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>)

요청의 HTTP 부분이 종료될 때 발생하는 가상 이벤트를 발생시킵니다.Raises a virtual event that occurs when the HTTP part of the request is ending.

ClearError() ClearError() ClearError() ClearError()

현재 HTTP 요청에 대한 오류를 모두 지웁니다.Clears all errors for the current HTTP request.

DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable)

이 요청의 Dispose() 연결 부분이 완료될 때 호출할 개체의 AspNetWebSocket 메서드를 사용하도록 설정합니다.Enables an object's Dispose() method to be called when the AspNetWebSocket connection part of this request is completed.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAppConfig(String) GetAppConfig(String) GetAppConfig(String) GetAppConfig(String)

현재 애플리케이션에 대해 요청된 구성 정보를 반환합니다.Returns requested configuration information for the current application.

GetConfig(String) GetConfig(String) GetConfig(String) GetConfig(String)

현재 HTTP 요청에 대해 요청된 구성 정보를 반환합니다.Returns requested configuration information for the current HTTP request.

GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String)

지정된 ClassKeyResourceKey 속성에 따라 애플리케이션 수준의 리소스 개체를 가져옵니다.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo)

지정된 ClassKeyResourceKey 속성과 CultureInfo 개체에 따라 애플리케이션 수준의 리소스 개체를 가져옵니다.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, and on the CultureInfo object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLocalResourceObject(String, String) GetLocalResourceObject(String, String) GetLocalResourceObject(String, String) GetLocalResourceObject(String, String)

지정된 VirtualPathResourceKey 속성에 따라 페이지 수준의 리소스 개체를 가져옵니다.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties.

GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo)

지정된 VirtualPathResourceKey 속성과 CultureInfo 개체에 따라 페이지 수준의 리소스 개체를 가져옵니다.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties, and on the CultureInfo object.

GetSection(String) GetSection(String) GetSection(String) GetSection(String)

현재 애플리케이션의 기본 구성에 대해 지정된 구성 섹션을 가져옵니다.Gets a specified configuration section for the current application's default configuration.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
RemapHandler(IHttpHandler) RemapHandler(IHttpHandler) RemapHandler(IHttpHandler) RemapHandler(IHttpHandler)

요청에 대한 처리기를 지정할 수 있습니다.Enables you to specify a handler for the request.

RewritePath(String) RewritePath(String) RewritePath(String) RewritePath(String)

지정한 경로를 사용하여 URL을 다시 작성합니다.Rewrites the URL using the given path.

RewritePath(String, Boolean) RewritePath(String, Boolean) RewritePath(String, Boolean) RewritePath(String, Boolean)

지정된 경로와 서버 리소스의 가상 경로가 수정되었는지 여부를 지정하는 부울 값을 사용하여 URL을 다시 작성합니다.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) RewritePath(String, String, String) RewritePath(String, String, String) RewritePath(String, String, String)

지정된 경로, 경로 정보 및 쿼리 문자열 정보를 사용하여 URL을 다시 작성합니다.Rewrites the URL by using the given path, path information, and query string information.

RewritePath(String, String, String, Boolean) RewritePath(String, String, String, Boolean) RewritePath(String, String, String, Boolean) RewritePath(String, String, String, Boolean)

지정된 가상 경로, 경로 정보, 쿼리 문자열 정보 및 클라이언트 파일 경로가 다시 작성 경로로 설정되었는지 여부를 지정하는 부울 값을 사용하여 URL을 다시 작성합니다.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) SetSessionStateBehavior(SessionStateBehavior) SetSessionStateBehavior(SessionStateBehavior) SetSessionStateBehavior(SessionStateBehavior)

HTTP 요청을 지원하기 위해 필요한 세션 상태 동작의 유형을 설정합니다.Sets the type of session state behavior that is required in order to support an HTTP request.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

명시적 인터페이스 구현

IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type)

현재 서비스 형식에 대한 개체를 반환합니다.Returns an object for the current service type.

적용 대상

추가 정보