次の方法で共有


MessageQueueInstaller クラス

定義

アプリケーションの実行に必要なキューのインストールと構成ができます。 このクラスは、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
継承

注釈

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

キューをインストールするには、 から継承するプロジェクト インストーラー クラスを Installer作成し、 クラスの を RunInstallerAttributetrue設定します。 プロジェクト内で、インストール内の 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

ComponentISite を取得または設定します。

(継承元 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)

適用対象

こちらもご覧ください