HostingEnvironment.RegisterObject メソッド

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

HostingEnvironment.RegisterObject メソッド

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

アプリケーションの登録済みオブジェクトのリストにオブジェクトを追加します。

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

Visual Basic (宣言)

Public Shared Sub RegisterObject
 ( _
    obj As IRegisteredObject _
)

Visual Basic (使用法)

Dim obj As IRegisteredObject

HostingEnvironment.RegisterObject(obj)

C#

public static void RegisterObject
 (
    IRegisteredObject obj
)

C++

public:
static void RegisterObject (
    IRegisteredObject^ obj
)

J#

public static void RegisterObject
 (
    IRegisteredObject obj
)

JScript

public static function RegisterObject
 (
    obj : IRegisteredObject
)

パラメータ

obj

登録するオブジェクト。

解説

ApplicationManager クラスを使用すると、現在のアプリケーション ドメイン外にあるメソッドによって、現在のアプリケーション ドメイン内のオブジェクトを作成、管理、および破棄できるようになります。RegisterObject メソッドは、既に作成済みのオブジェクトをホスト環境に登録するために使用します。RegisterObject メソッドを使用して登録したオブジェクトは、IRegisteredObject インターフェイスを実装している必要があります。

登録済みのオブジェクトを使用するには、次の手順を実行します。

1. ApplicationManager.CreateObject メソッドを呼び出して、登録済みのオブジェクトの新しいインスタンスを作成します。

2. 型固有のメソッドを呼び出して、新しいオブジェクトを初期化します。初期化メソッドで、RegisterObject メソッドを呼び出して登録済みのオブジェクトのリストにオブジェクトを追加します。

3. 必要に応じて、ApplicationManager.GetObject メソッドを呼び出して、登録済みのオブジェクトを返します。

4. オブジェクトを停止する場合は、ApplicationManager.StopObject メソッドを呼び出します。ApplicationManager.StopObject メソッドは、次に IRegisteredObject.Stop メソッドを呼び出します。

5. IRegisteredObject.Stop メソッドでは、オブジェクトから UnregisterObject メソッドを呼び出す必要があります。

使用例

登録済みのオブジェクトに Start メソッドを実装する方法を次のコード例に示します。例の実行に必要なコード全体については、IRegisteredObject インターフェイスの概要のトピックで「使用例」を参照してください。

Visual Basic

Public Sub Start()
  HostingEnvironment.RegisterObject(Me)
End Sub

C#

public void Start()
{
  HostingEnvironment.RegisterObject(this);
}

.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 名前空間
UnregisterObject
IRegisteredObject
CreateObject