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 HttpContextIHttpHandlerインターフェイスを継承するクラスには、現在の 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

Web 要求の処理で使用されるメソッドを提供する 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)

アプリケーション レベル リソース オブジェクトを、指定した ClassKey プロパティおよび ResourceKey プロパティに基づいて取得します。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)

アプリケーション レベル リソース オブジェクトを、指定した ClassKey プロパティおよび ResourceKey プロパティ、および 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)

ページ レベル リソース オブジェクトを、指定した VirtualPath プロパティおよび ResourceKey プロパティに基づいて取得します。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)

ページ レベル リソース オブジェクトを、指定した VirtualPath プロパティおよび ResourceKey プロパティ、および 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.

適用対象

こちらもご覧ください