MessageQueueInstaller

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

MessageQueueInstaller イベント

パブリック イベント

	名前	説明
	AfterInstall	Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。 ( Installer から継承されます。)
	AfterRollback	Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。 ( Installer から継承されます。)
	AfterUninstall	Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。 ( Installer から継承されます。)
	BeforeInstall	インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。 ( Installer から継承されます。)
	BeforeRollback	Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。 ( Installer から継承されます。)
	BeforeUninstall	Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。 ( Installer から継承されます。)
	Committed	Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。 ( Installer から継承されます。)
	Committing	Installers プロパティ内のインストーラがインストールをコミットする前に発生します。 ( Installer から継承されます。)
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)

参照

関連項目

MessageQueueInstaller クラス
System.Messaging 名前空間

その他の技術情報

インストーラ ツール (Installutil.exe)

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)

MessageQueueInstaller コンストラクタ ()

MessageQueueInstaller クラスの新しいインスタンスを初期化します。インスタンス プロパティは設定しません。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New MessageQueueInstaller

C#

public MessageQueueInstaller ()

C++

public:
MessageQueueInstaller ()

J#

public MessageQueueInstaller ()

JScript

public function MessageQueueInstaller ()

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 クラス
MessageQueueInstaller メンバ
System.Messaging 名前空間

MessageQueueInstaller コンストラクタ

MessageQueueInstaller クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
MessageQueueInstaller ()	MessageQueueInstaller クラスの新しいインスタンスを初期化します。インスタンス プロパティは設定しません。
MessageQueueInstaller (MessageQueue)	MessageQueueInstaller クラスの新しいインスタンスを初期化し、インストール設定を既存の MessageQueue インスタンスの設定に初期化します。

参照

関連項目

MessageQueueInstaller クラス
MessageQueueInstaller メンバ
System.Messaging 名前空間

MessageQueueInstaller コンストラクタ (MessageQueue)

MessageQueueInstaller クラスの新しいインスタンスを初期化し、インストール設定を既存の MessageQueue インスタンスの設定に初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    componentToCopy As MessageQueue _
)

Visual Basic (使用法)

Dim componentToCopy As MessageQueue

Dim instance As New MessageQueueInstaller(componentToCopy)

C#

public MessageQueueInstaller (
    MessageQueue componentToCopy
)

C++

public:
MessageQueueInstaller (
    MessageQueue^ componentToCopy
)

J#

public MessageQueueInstaller (
    MessageQueue componentToCopy
)

JScript

public function MessageQueueInstaller (
    componentToCopy : MessageQueue
)

パラメータ

componentToCopy

インストールされる新しいキューのプロパティ設定を決定する MessageQueue コンポーネント。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 クラス
MessageQueueInstaller メンバ
System.Messaging 名前空間

MessageQueueInstaller プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Authenticate	インストールされるキューが認証済みメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	BasePriority	ネットワーク上でパブリック キューのメッセージをルーティングするときに使用する基本優先順位を取得または設定します。
	Category	実装に固有のキューの種類を取得または設定します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	Context	現在のインストールに関する情報を取得または設定します。 ( Installer から継承されます。)
	EncryptionRequired	キューがプライベート メッセージ、つまり暗号化されたメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	HelpText	インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。 ( Installer から継承されます。)
	Installers	インストーラが格納しているインストーラのコレクションを取得します。 ( Installer から継承されます。)
	Label	キューの説明を取得または設定します。
	MaximumJournalSize	キューに関連付けられたジャーナルの最大サイズを取得または設定します。
	MaximumQueueSize	キューの最大サイズを取得または設定します。
	MulticastAddress	MSMQ 3.0 で導入されました。キューに関連付けられているマルチキャスト アドレスを取得または設定します。
	Parent	インストーラが属しているコレクションを格納しているインストーラを取得または設定します。 ( Installer から継承されます。)
	Path	このオブジェクトが参照するキューの場所を取得または設定します。
	Permissions	キューに関連付けられているアクセス許可を取得または設定します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	Transactional	キューがトランザクションの一部として送信されたメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	UninstallAction	アンインストールするときにインストーラがキューに対して実行する操作を示す値を取得または設定します。実行できる操作には、削除、インストール前の状態への復元、現在のインストールされた状態の維持があります。
	UseJournalQueue	キューから取得したメッセージを関連付けられたジャーナル キューにもコピーするかどうかを示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

MessageQueueInstaller クラス
System.Messaging 名前空間

その他の技術情報

インストーラ ツール (Installutil.exe)

MessageQueueInstaller メソッド

パブリック メソッド

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

	名前	説明
	Commit	オーバーライドされます。 Install メソッドによってレジストリに書き込まれた MessageQueue インストール情報をコミットして、インストール プロセスを完了します。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	CopyFromComponent	オーバーライドされます。 インストールするときにメッセージ キューに必要な、MessageQueue コンポーネントのプロパティ値をコピーします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Install	オーバーライドされます。 インストールを実行し、レジストリにメッセージ キュー情報を書き込みます。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	IsEquivalentInstaller	オーバーライドされます。 指定したインストーラがこのインストーラと同じ種類のインストールを処理できるかどうかを判断します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Rollback	オーバーライドされます。 インストール プロシージャによってレジストリに書き込まれたキュー情報をロールバックして、コンピュータをインストール前の状態に復元します。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
	Uninstall	オーバーライドされます。 レジストリからキュー情報を削除して、インストールされているキューを削除します。このメソッドは、アンインストール ツールで使用されます。アンインストール ツールは適切なメソッドを自動的に呼び出します。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnAfterInstall	AfterInstall イベントを発生させます。 ( Installer から継承されます。)
	OnAfterRollback	AfterRollback イベントを発生させます。 ( Installer から継承されます。)
	OnAfterUninstall	AfterUninstall イベントを発生させます。 ( Installer から継承されます。)
	OnBeforeInstall	BeforeInstall イベントを発生させます。 ( Installer から継承されます。)
	OnBeforeRollback	BeforeRollback イベントを発生させます。 ( Installer から継承されます。)
	OnBeforeUninstall	BeforeUninstall イベントを発生させます。 ( Installer から継承されます。)
	OnCommitted	Committed イベントを発生させます。 ( Installer から継承されます。)
	OnCommitting	Committing イベントを発生させます。 ( Installer から継承されます。)

参照

関連項目

MessageQueueInstaller クラス
System.Messaging 名前空間

その他の技術情報

インストーラ ツール (Installutil.exe)

MessageQueueInstaller メンバ

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

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

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

	名前	説明
	MessageQueueInstaller	オーバーロードされます。 MessageQueueInstaller クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Authenticate	インストールされるキューが認証済みメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	BasePriority	ネットワーク上でパブリック キューのメッセージをルーティングするときに使用する基本優先順位を取得または設定します。
	Category	実装に固有のキューの種類を取得または設定します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	Context	現在のインストールに関する情報を取得または設定します。(Installer から継承されます。)
	EncryptionRequired	キューがプライベート メッセージ、つまり暗号化されたメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	HelpText	インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。(Installer から継承されます。)
	Installers	インストーラが格納しているインストーラのコレクションを取得します。(Installer から継承されます。)
	Label	キューの説明を取得または設定します。
	MaximumJournalSize	キューに関連付けられたジャーナルの最大サイズを取得または設定します。
	MaximumQueueSize	キューの最大サイズを取得または設定します。
	MulticastAddress	MSMQ 3.0 で導入されました。キューに関連付けられているマルチキャスト アドレスを取得または設定します。
	Parent	インストーラが属しているコレクションを格納しているインストーラを取得または設定します。(Installer から継承されます。)
	Path	このオブジェクトが参照するキューの場所を取得または設定します。
	Permissions	キューに関連付けられているアクセス許可を取得または設定します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	Transactional	キューがトランザクションの一部として送信されたメッセージだけを受け入れるかどうかを示す値を取得または設定します。
	UninstallAction	アンインストールするときにインストーラがキューに対して実行する操作を示す値を取得または設定します。実行できる操作には、削除、インストール前の状態への復元、現在のインストールされた状態の維持があります。
	UseJournalQueue	キューから取得したメッセージを関連付けられたジャーナル キューにもコピーするかどうかを示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

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

	名前	説明
	Commit	オーバーライドされます。 Install メソッドによってレジストリに書き込まれた MessageQueue インストール情報をコミットして、インストール プロセスを完了します。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	CopyFromComponent	オーバーライドされます。 インストールするときにメッセージ キューに必要な、MessageQueue コンポーネントのプロパティ値をコピーします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Install	オーバーライドされます。 インストールを実行し、レジストリにメッセージ キュー情報を書き込みます。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	IsEquivalentInstaller	オーバーライドされます。 指定したインストーラがこのインストーラと同じ種類のインストールを処理できるかどうかを判断します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Rollback	オーバーライドされます。 インストール プロシージャによってレジストリに書き込まれたキュー情報をロールバックして、コンピュータをインストール前の状態に復元します。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
	Uninstall	オーバーライドされます。 レジストリからキュー情報を削除して、インストールされているキューを削除します。このメソッドは、アンインストール ツールで使用されます。アンインストール ツールは適切なメソッドを自動的に呼び出します。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnAfterInstall	AfterInstall イベントを発生させます。 (Installer から継承されます。)
	OnAfterRollback	AfterRollback イベントを発生させます。 (Installer から継承されます。)
	OnAfterUninstall	AfterUninstall イベントを発生させます。 (Installer から継承されます。)
	OnBeforeInstall	BeforeInstall イベントを発生させます。 (Installer から継承されます。)
	OnBeforeRollback	BeforeRollback イベントを発生させます。 (Installer から継承されます。)
	OnBeforeUninstall	BeforeUninstall イベントを発生させます。 (Installer から継承されます。)
	OnCommitted	Committed イベントを発生させます。 (Installer から継承されます。)
	OnCommitting	Committing イベントを発生させます。 (Installer から継承されます。)

パブリック イベント

	名前	説明
	AfterInstall	Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。(Installer から継承されます。)
	AfterRollback	Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。(Installer から継承されます。)
	AfterUninstall	Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。(Installer から継承されます。)
	BeforeInstall	インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。(Installer から継承されます。)
	BeforeRollback	Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。(Installer から継承されます。)
	BeforeUninstall	Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。(Installer から継承されます。)
	Committed	Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。(Installer から継承されます。)
	Committing	Installers プロパティ内のインストーラがインストールをコミットする前に発生します。(Installer から継承されます。)
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)

参照

関連項目

MessageQueueInstaller クラス
System.Messaging 名前空間

その他の技術情報

インストーラ ツール (Installutil.exe)