HostingEnvironment

.NET Framework クラス ライブラリ リファレンス

HostingEnvironment クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション ドメイン内でマネージ アプリケーションにアプリケーション管理機能およびアプリケーション サービスを提供します。このクラスは継承できません。

名前空間: System.Web.Hosting
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 HostingEnvironment
    Inherits MarshalByRefObject

Visual Basic (使用法)

Dim instance As HostingEnvironment

C#

public sealed class HostingEnvironment : MarshalByRefObject

C++

public ref class HostingEnvironment sealed
 : public MarshalByRefObject

J#

public final class HostingEnvironment extends
 MarshalByRefObject

JScript

public final class HostingEnvironment extends
 MarshalByRefObject

解説

各マネージ アプリケーション ドメインには、アプリケーション管理機能およびアプリケーション サービスへのアクセスを提供する HostingEnvironment クラスの静的インスタンスがあります。

使用例

HostingEnvironment オブジェクトから入手できるアプリケーション情報を表示する Web ページのコード例を次に示します。

Visual Basic

<%@ 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 >
<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>

C#

<%@ 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 >
<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>

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.MarshalByRefObject
    System.Web.Hosting.HostingEnvironment

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HostingEnvironment メンバ
System.Web.Hosting 名前空間

HostingEnvironment コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

HostingEnvironment クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Hosting
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New HostingEnvironment

C#

public HostingEnvironment ()

C++

public:
HostingEnvironment ()

J#

public HostingEnvironment ()

JScript

public function HostingEnvironment ()

例外

例外の種類	条件
InvalidOperationException	HostingEnvironment コンストラクタが、何度も呼び出されています。

解説

HostingEnvironment コンストラクタは、HostingEnvironment オブジェクトを初期化します。HostingEnvironment コンストラクタは、アプリケーションの ApplicationManager オブジェクトによって 1 回だけ呼び出されます。HostingEnvironment コンストラクタを複数回呼び出すと、InvalidOperationException 例外がスローされます。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
• SecurityPermission  (コンストラクタを呼び出すために必要なアクセス許可)。要求値 : Demand。アクセス許可値 : Unrestricted。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HostingEnvironment クラス
HostingEnvironment メンバ
System.Web.Hosting 名前空間

HostingEnvironment プロパティ

パブリック プロパティ

	名前	説明
	ApplicationID	アプリケーションの一意の識別子を取得します。
	ApplicationPhysicalPath	アプリケーションのディレクトリへのディスク上の物理パスを取得します。
	ApplicationVirtualPath	アプリケーションのルートへの仮想パスを取得します。
	Cache	現在のアプリケーションに対する Cache インスタンスを取得します。
	InitializationException	HostingEnvironment オブジェクトの初期化中にスローされた例外を取得します。
	IsHosted	現在のアプリケーション ドメインが ApplicationManager オブジェクトによってホストされているかどうかを示す値を取得します。
	ShutdownReason	アプリケーションの終了理由を示す列挙値を返します。
	SiteName	サイトの名前を取得します。
	VirtualPathProvider	このアプリケーションの仮想パス プロバイダを取得します。

参照

関連項目

HostingEnvironment クラス
System.Web.Hosting 名前空間

HostingEnvironment メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	DecrementBusyCount	ホスト環境のビジー オブジェクトの数を 1 つ減らします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Impersonate	オーバーロードされます。 コードによって別のユーザーを偽装できるようにします。
	IncrementBusyCount	ホスト環境のビジー オブジェクトの数を 1 つ増やします。
	InitializeLifetimeService	オーバーライドされます。 リースが作成されないようにすることで、HostingEnvironment オブジェクトに無期限の有効期間を指定します。
	InitiateShutdown	このホストに関連付けられている Web アプリケーションのシャットダウンを開始し、登録済みのオブジェクトをシステムから削除します。
	MapPath	サーバー上の物理パスに仮想パスを割り当てます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RegisterObject	アプリケーションの登録済みオブジェクトのリストにオブジェクトを追加します。
	RegisterVirtualPathProvider	ASP.NET コンパイル システムに新しい VirtualPathProvider インスタンスを登録します。
	SetCultures	オーバーロードされます。 現在のスレッドのカルチャ情報を設定します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	UnregisterObject	アプリケーションの登録済みのオブジェクトのリストからオブジェクトを削除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

HostingEnvironment クラス
System.Web.Hosting 名前空間

HostingEnvironment メンバ

アプリケーション ドメイン内でマネージ アプリケーションにアプリケーション管理機能およびアプリケーション サービスを提供します。このクラスは継承できません。

HostingEnvironment データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	HostingEnvironment	HostingEnvironment クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ApplicationID	アプリケーションの一意の識別子を取得します。
	ApplicationPhysicalPath	アプリケーションのディレクトリへのディスク上の物理パスを取得します。
	ApplicationVirtualPath	アプリケーションのルートへの仮想パスを取得します。
	Cache	現在のアプリケーションに対する Cache インスタンスを取得します。
	InitializationException	HostingEnvironment オブジェクトの初期化中にスローされた例外を取得します。
	IsHosted	現在のアプリケーション ドメインが ApplicationManager オブジェクトによってホストされているかどうかを示す値を取得します。
	ShutdownReason	アプリケーションの終了理由を示す列挙値を返します。
	SiteName	サイトの名前を取得します。
	VirtualPathProvider	このアプリケーションの仮想パス プロバイダを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	DecrementBusyCount	ホスト環境のビジー オブジェクトの数を 1 つ減らします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Impersonate	オーバーロードされます。 コードによって別のユーザーを偽装できるようにします。
	IncrementBusyCount	ホスト環境のビジー オブジェクトの数を 1 つ増やします。
	InitializeLifetimeService	オーバーライドされます。 リースが作成されないようにすることで、HostingEnvironment オブジェクトに無期限の有効期間を指定します。
	InitiateShutdown	このホストに関連付けられている Web アプリケーションのシャットダウンを開始し、登録済みのオブジェクトをシステムから削除します。
	MapPath	サーバー上の物理パスに仮想パスを割り当てます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RegisterObject	アプリケーションの登録済みオブジェクトのリストにオブジェクトを追加します。
	RegisterVirtualPathProvider	ASP.NET コンパイル システムに新しい VirtualPathProvider インスタンスを登録します。
	SetCultures	オーバーロードされます。 現在のスレッドのカルチャ情報を設定します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	UnregisterObject	アプリケーションの登録済みのオブジェクトのリストからオブジェクトを削除します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

HostingEnvironment クラス
System.Web.Hosting 名前空間