MessageQueueInstaller 類別

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

讓您安裝和設定執行應用程式時需要的佇列 (Queue)。 安裝 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安裝所有佇列。 如果 為 RunInstallerAttributefalse，則公用程式會忽略專案安裝程式。

您可以在將 實體新增至Installers專案安裝程式的集合之前或之後修改實例的其他屬性MessageQueueInstaller。 例如，必須先設定佇列的 Path ，才能執行安裝公用程式。

一般而言，您不會從程式碼中呼叫 的方法 MessageQueueInstaller ;它們通常只會由 installutil.exe 安裝公用程式呼叫。 公用程式會在安裝程式期間自動呼叫 Install 方法，並在安裝未擲回例外狀況時呼叫 Commit 。 如有必要，它會呼叫 Rollback 產生例外狀況的物件，以回復失敗。

應用程式的安裝例程會使用專案安裝程式 Installer.Context 自動維護已安裝之元件的相關信息。 此狀態資訊會持續更新，因為公用程式會安裝每個 MessageQueueInstaller 實例。 您程式代碼通常不需要明確修改狀態資訊。

建構函式

MessageQueueInstaller()	初始化 MessageQueueInstaller 類別的新執行個體。 沒有設定任何執行個體屬性。
MessageQueueInstaller(MessageQueue)	初始化 MessageQueueInstaller 類別的新執行個體，將安裝設定初始化為現存的 MessageQueue 執行個體的安裝設定。

屬性

Authenticate	取得或設定值，指出要安裝的佇列是否只接受已驗證的訊息。
BasePriority	取得或設定用來在網路上傳送公用 (Public) 佇列訊息的基礎優先權 (Base Priority)。
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Category	取得或設定實作 (Implementation) 特定的佇列類型。
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)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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 (安裝程式工具)