MessageQueueInstaller クラス

リファレンス

定義

名前空間:: System.Messaging

アセンブリ:: System.Messaging.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

継承: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
MessageQueueInstaller

注釈

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

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

インスタンスを MessageQueueInstaller 作成するときに、必要に応じて、既存 MessageQueue の (テストサーバーからなど) をコンストラクターに MessageQueueInstaller 渡すことができます。この方法では、渡されたキューの設定をミラーリングすることで、新しいキューの構成設定が自動的に提供されます。または、インスタンスのプロパティを目的の状態に手動で MessageQueueInstaller 設定し、パラメーターなしのコンストラクターを呼び出すこともできます。

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

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

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

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

コンストラクター

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

プロパティ

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

メソッド

Commit(IDictionary)	MessageQueue メソッドによってレジストリに書き込まれた Install(IDictionary) インストール情報をコミットして、インストールプロセスを完了します。このメソッドは、セットアップツールで使用されます。セットアップツールは適切なメソッドを自動的に呼び出します。
CopyFromComponent(IComponent)	インストールするときにメッセージキューに必要な、MessageQueue コンポーネントのプロパティ値をコピーします。
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	Component によって使用されているすべてのリソースを解放します。 (継承元 Component)
Dispose(Boolean)	Component によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 Component)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetService(Type)	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
Install(IDictionary)	インストールを実行し、レジストリにメッセージキュー情報を書き込みます。このメソッドは、セットアップツールで使用されます。セットアップツールは適切なメソッドを自動的に呼び出します。
IsEquivalentInstaller(ComponentInstaller)	指定したインストーラーがこのインストーラーと同じ種類のインストールを処理できるかどうかを判断します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall イベントを発生させます。 (継承元 Installer)
OnAfterRollback(IDictionary)	AfterRollback イベントを発生させます。 (継承元 Installer)
OnAfterUninstall(IDictionary)	AfterUninstall イベントを発生させます。 (継承元 Installer)
OnBeforeInstall(IDictionary)	BeforeInstall イベントを発生させます。 (継承元 Installer)
OnBeforeRollback(IDictionary)	BeforeRollback イベントを発生させます。 (継承元 Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall イベントを発生させます。 (継承元 Installer)
OnCommitted(IDictionary)	Committed イベントを発生させます。 (継承元 Installer)
OnCommitting(IDictionary)	Committing イベントを発生させます。 (継承元 Installer)
Rollback(IDictionary)	インストールプロシージャによってレジストリに書き込まれたキュー情報をロールバックして、コンピューターをインストール前の状態に復元します。このメソッドは、セットアップツールで使用されます。セットアップツールは適切なメソッドを自動的に呼び出します。
ToString()	Component の名前 (存在する場合) を格納する String を返します。このメソッドはオーバーライドできません。 (継承元 Component)
Uninstall(IDictionary)	レジストリからキュー情報を削除して、インストールされているキューを削除します。このメソッドは、アンインストールツールで使用されます。アンインストールツールは適切なメソッドを自動的に呼び出します。

イベント

AfterInstall	Installers プロパティ内のすべてのインストーラーの Install(IDictionary) メソッドが実行された後で発生します。 (継承元 Installer)
AfterRollback	Installers プロパティ内のすべてのインストーラーによるインストールがロールバックされた後で発生します。 (継承元 Installer)
AfterUninstall	Installers プロパティ内のすべてのインストーラーのアンインストールが実行された後で発生します。 (継承元 Installer)
BeforeInstall	インストーラーコレクション内の各インストーラーの Install(IDictionary) メソッドが実行される前に発生します。 (継承元 Installer)
BeforeRollback	Installers プロパティ内のインストーラーがロールバックされる前に発生します。 (継承元 Installer)
BeforeUninstall	Installers プロパティ内のインストーラーのアンインストールが実行される前に発生します。 (継承元 Installer)
Committed	Installers プロパティ内のすべてのインストーラーがインストールをコミットした後で発生します。 (継承元 Installer)
Committing	Installers プロパティ内のインストーラーがインストールをコミットする前に発生します。 (継承元 Installer)
Disposed	Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component)

適用対象

こちらもご覧ください

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