MessageQueueInstaller.Install(IDictionary) 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
執行安裝，並將訊息佇列資訊寫入至登錄。 這個方法是安裝工具所使用的方法，安裝工具會自動呼叫適當的方法。
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install (System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)- stateSaver
- IDictionary
IDictionary，用於儲存執行認可、復原或解除安裝作業所需的資訊。
方法Install會將消息佇列資訊寫入登錄，並將實例與位於 屬性所指定路徑的Path佇列產生關聯MessageQueue。 如果佇列不存在， Install 請建立交易式佇列。 Install 會將新的或現有的佇列屬性設定為您在 中指定的 MessageQueueInstaller佇列屬性。 如果佇列已經存在，其屬性會重設為 的 MessageQueueInstaller。 如果現有的佇列不是交易式佇列，則會將其刪除，然後重新建立為交易式佇列。
警告
如果需要重新建立佇列，佇列中的訊息將會遺失。
一般而言，您不會從程式代碼內呼叫 的方法 MessageQueueInstaller ;它們通常只能由 installutil.exe 安裝公用程式呼叫。 公用程式會在安裝程式期間自動呼叫 Install 方法，以撰寫與所安裝消息佇列相關聯的登錄資訊。 安裝是交易式的，因此如果在安裝期間有任何安裝專案元件失敗，所有先前安裝的元件都會回復到其安裝前狀態。 這是藉由呼叫每個元件的 Rollback 方法來完成。
成功安裝與安裝專案相關聯的所有元件之後，安裝公用程式就會認可安裝。 Commit 將佇列設定為適當的初始狀態，以完成的安裝 MessageQueue 。 如果 屬性指定的 Path 佇列已經存在且包含訊息， Commit 則會清除訊息。 Commit，而不是 Install會清除訊息，因為無法復原清除訊息的動作。
應用程式的安裝例程會使用專案安裝程式 Installer.Context 自動維護已安裝之元件的相關信息。 當公用程式安裝每個MessageQueueInstaller實例時，會持續更新傳遞至 Install 作為 stateSaver 參數的這個狀態資訊。 通常，您的程式代碼不需要明確地修改此狀態資訊。
| 產品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
