HostingEnvironment HostingEnvironment HostingEnvironment HostingEnvironment Class

定義

アプリケーション ドメイン内でマネージド アプリケーションにアプリケーション管理機能およびアプリケーション サービスを提供します。Provides application-management functions and application services to a managed application within its application domain. このクラスは継承できません。This class cannot be inherited.

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
継承
HostingEnvironmentHostingEnvironmentHostingEnvironmentHostingEnvironment

次のコード例は、web ページから使用可能なアプリケーション情報を表示する、HostingEnvironmentオブジェクト。The following code example is a webpage that displays the application information available from the HostingEnvironment object.

<%@ Page Language="C#" %>

<%@ Import Namespace="System.Web.Hosting" %>
<!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)
  {
    appID.Text = HostingEnvironment.ApplicationID;
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath;
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath;
    siteName.Text = HostingEnvironment.SiteName;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Hosting" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    appID.Text = HostingEnvironment.ApplicationID
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath
    siteName.Text = HostingEnvironment.SiteName
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

注釈

各管理対象のアプリケーション ドメインには静的インスタンスが含まれています、HostingEnvironmentクラスは、アプリケーション管理機能およびアプリケーション サービスへのアクセスを提供します。Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

コンストラクター

HostingEnvironment() HostingEnvironment() HostingEnvironment() HostingEnvironment()

HostingEnvironment クラスの新しいインスタンスを初期化します。Initializes a new instance of the HostingEnvironment class.

プロパティ

ApplicationHost ApplicationHost ApplicationHost ApplicationHost

このプロパティは、ASP.NETASP.NET インフラストラクチャをサポートします。コードから直接使用するためのものではありません。This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID ApplicationID ApplicationID ApplicationID

アプリケーションの一意の識別子を取得します。Gets the unique identifier of the application.

ApplicationMonitors ApplicationMonitors ApplicationMonitors ApplicationMonitors

アプリケーションを正常な状態に保つために ASP.NET サブシステムによって使用されている置き換え可能なモニター オブジェクトのグループを取得します。Gets a group of replaceable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath

アプリケーションのディレクトリへのディスク上の物理パスを取得します。Gets the physical path on disk to the application's directory.

ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath

アプリケーションのルートへの仮想パスを取得します。Gets the root virtual path of the application.

Cache Cache Cache Cache

現在のアプリケーションに対する Cache インスタンスを取得します。Gets the Cache instance for the current application.

InClientBuildManager InClientBuildManager InClientBuildManager InClientBuildManager

ホスティング環境が ASP.NET ビルド システムにアクセスできるかどうかを示す値を取得します。Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException InitializationException InitializationException InitializationException

HostingEnvironment オブジェクトの初期化中にスローされた例外を取得します。Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment

現在のアプリケーションが開発環境で実行されているかどうかを示す値を取得します。Gets a value that indicates whether the current application is in a development environment.

IsHosted IsHosted IsHosted IsHosted

現在のアプリケーション ドメインが ApplicationManager オブジェクトによってホストされているかどうかを示す値を取得します。Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU

CPU あたりの同時実行される要求の最大数を取得または設定します。Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU

CPU あたりの同時実行されるスレッドの最大数を取得または設定します。Gets or sets the maximum concurrent threads per CPU.

ShutdownReason ShutdownReason ShutdownReason ShutdownReason

アプリケーションの終了理由を示す列挙値を返します。Returns an enumerated value that indicates why the application terminated.

SiteName SiteName SiteName SiteName

サイトの名前を取得します。Gets the name of the site.

VirtualPathProvider VirtualPathProvider VirtualPathProvider VirtualPathProvider

このアプリケーションの仮想パス プロバイダーを取得します。Gets the virtual path provider for this application.

メソッド

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DecrementBusyCount() DecrementBusyCount() DecrementBusyCount() DecrementBusyCount()

ホスト環境のビジー オブジェクトの数を 1 つ減らします。Reduces the count of busy objects in the hosted environment by one.

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

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Impersonate() Impersonate() Impersonate() Impersonate()

アプリケーション ID によって表されるユーザーを偽装します。Impersonates the user represented by the application identity.

Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr)

指定したユーザー トークンによって表されるユーザーを偽装します。Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String)

指定した仮想パスまたは指定したユーザー トークンについて構成設定で指定されたユーザーを偽装します。Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

IncrementBusyCount() IncrementBusyCount() IncrementBusyCount() IncrementBusyCount()

ホスト環境のビジー オブジェクトの数を 1 つ増やします。Increases the count of busy objects in the hosted environment by one.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

リースが作成されないようにすることで、HostingEnvironment オブジェクトに無期限の有効期間を指定します。Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

InitiateShutdown() InitiateShutdown() InitiateShutdown() InitiateShutdown()

このホストに関連付けられている web アプリケーションのシャットダウンを開始し、登録済みのオブジェクトをシステムから削除します。Starts shutting down the web application associated with this host and removes registered objects from the system.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

サーバー上の物理パスに仮想パスを割り当てます。Maps a virtual path to a physical path on the server.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

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

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MessageReceived() MessageReceived() MessageReceived() MessageReceived()

このメソッドは、ASP.NETASP.NET インフラストラクチャをサポートしますが、独自に作成したコードから直接使用するためのものではありません。This method supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>)

どの要求とも独立した形で、バック グラウンドで実行するタスクをスケジュールします。Schedules a task which can run in the background, independent of any request.

QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>)

どの要求とも独立した形で、バック グラウンドで実行するタスクをスケジュールします。Schedules a task which can run in the background, independent of any request.

RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject)

アプリケーションの登録済みオブジェクトのリストにオブジェクトを追加します。Places an object in the list of registered objects for the application.

RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider)

ASP.NET コンパイル システムに新しい VirtualPathProvider インスタンスを登録します。Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

SetCultures() SetCultures() SetCultures() SetCultures()

現在のスレッドを、アプリケーションの構成ファイルで指定されたカルチャに設定します。Sets the current thread to the culture specified in the application configuration file.

SetCultures(String) SetCultures(String) SetCultures(String) SetCultures(String)

現在のカルチャを、指定した仮想パスのカルチャに設定します。Sets the current thread to the culture of the specified virtual path.

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

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject)

アプリケーションの登録済みのオブジェクトのリストからオブジェクトを削除します。Removes an object from the list of registered objects for the application.

イベント

StopListening StopListening StopListening StopListening

[.NET Framework 4.5.1 でのみサポートされます][Supported in the .NET Framework 4.5.1 only] 発生した時、ワーカーの処理か、このホストに関連付けられているアプリケーション プールが新しい要求のリッスンを停止して、最終的にシャット ダウンされるときに発生します。Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

適用対象