MessageQueueInstaller 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
允許你安裝並設定應用程式執行所需的佇列。 此類別由安裝工具稱為 ，InstallUtil.exe例如安裝 MessageQueue。
public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstallerpublic class MessageQueueInstaller : System.Configuration.Install.ComponentInstallertype MessageQueueInstaller = class
inherit ComponentInstallerPublic Class MessageQueueInstaller
Inherits 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 實例的安裝，這些狀態資訊會持續由工具更新。 通常你的程式碼不需要明確修改狀態資訊。
建構函式
| 名稱 | Description |
|---|---|
| MessageQueueInstaller() |
初始化 MessageQueueInstaller 類別的新執行個體。 不會設定任何實例屬性。 |
| MessageQueueInstaller(MessageQueue) |
初始化該類別的新實例 MessageQueueInstaller ，並將安裝設定初始化為現有 MessageQueue 實例的設定。 |
屬性
| 名稱 | Description |
|---|---|
| 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) |
| Transactional |
取得或設定一個值，指示佇列是否只接受作為交易一部分發送的訊息。 |
| UninstallAction |
會取得或設定一個值，指示安裝程式在卸載時對佇列做什麼：移除佇列、還原到安裝前的狀態，或保持目前安裝狀態。 |
| UseJournalQueue |
取得或設定一個值，指示從佇列擷取的訊息是否也會複製到對應的日誌佇列。 |
方法
事件
| 名稱 | Description |
|---|---|
| AfterInstall |
發生在 Install(IDictionary) 所有安裝人員 Installers 的操作完成後。 (繼承來源 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) |
