MessageQueueInstaller クラス

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

MessageQueueInstaller クラス

アプリケーションの実行に必要なキューのインストールと構成ができます。このクラスは、MessageQueue をインストールするときに、InstallUtil.exe などのインストール ユーティリティによって呼び出されます。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Class MessageQueueInstaller
    Inherits ComponentInstaller

Visual Basic (使用法)

Dim instance As MessageQueueInstaller

C#

public class MessageQueueInstaller : ComponentInstaller

C++

public ref class MessageQueueInstaller : public
 ComponentInstaller

J#

public class MessageQueueInstaller extends
 ComponentInstaller

JScript

public class MessageQueueInstaller extends
 ComponentInstaller

解説

インストール ユーティリティは、MessageQueueInstaller を使用して、キューに関連付けられるレジストリ値を書き込みます。インストール ユーティリティの詳細については、「インストーラ ツール (Installutil.exe)」を参照してください。

キューをインストールするには、Installer から継承するプロジェクト インストーラ クラスを作成し、そのクラスの RunInstallerAttribute を true に設定します。プロジェクト内で、インストールの各キューの MessageQueueInstaller インスタンスを作成し、インスタンスをプロジェクト インストーラ クラスに追加します。

MessageQueueInstaller インスタンスを作成するときは、テスト サーバーのキューなど既存の MessageQueue を MessageQueueInstaller コンストラクタに渡すこともできます。この方法では、渡されたキューの設定を反映することによって、自動的に新しいキューの構成設定が指定されます。この方法を使用しない場合は、MessageQueueInstaller インスタンスのプロパティを必要な状態に手動で設定して、既定のコンストラクタを呼び出します。

インストール ユーティリティは、呼び出されると RunInstallerAttribute を検索します。このプロパティが true の場合、ユーティリティは、プロジェクト インストーラに関連付けられた Installers コレクションのすべてのキューをインストールします。RunInstallerAttribute が false の場合、ユーティリティはプロジェクト インストーラを無視します。

MessageQueueInstaller インスタンスのその他のプロパティは、インスタンスをプロジェクト インストーラの Installers コレクションに追加する前または後に変更します。たとえば、キューの Path は、インストール ユーティリティを実行する前に設定する必要があります。

通常、コードからは MessageQueueInstaller のメソッドを呼び出しません。一般的に、このメソッドを呼び出すのはインストール ユーティリティの installutil.exe だけです。ユーティリティは、インストール プロセス中に自動的に Install メソッドを呼び出します。また、インストールが例外をスローしなかった場合は、Commit を呼び出します。必要に応じて、例外を生成したオブジェクトに対して Rollback を呼び出すことにより、エラーを回復します。

アプリケーションのインストール ルーチンは、プロジェクト インストーラの Installer.Context を使用して、既にインストールされているコンポーネントに関する情報を自動的に認識します。この状態情報は、各 MessageQueueInstaller インスタンスがユーティリティによってインストールされるときに、継続的に更新されます。通常、コードではこの状態情報を明示的に変更する必要はありません。

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Configuration.Install.Installer
         System.Configuration.Install.ComponentInstaller
          System.Messaging.MessageQueueInstaller

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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、1.1、1.0

参照

関連項目
MessageQueueInstaller メンバ
System.Messaging 名前空間
その他の技術情報
インストーラ ツール (Installutil.exe)