EventLogInstaller.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 -> unit
Public Overrides Sub Install (stateSaver As IDictionary)
參數
- stateSaver
- IDictionary
IDictionary,用來儲存執行復原或解除安裝作業所需的資訊。
例外狀況
Source 屬性中指定的名稱是已經為不同事件記錄檔註冊的名稱。
備註
方法會將 Install 事件記錄檔資訊寫入登錄,並將事件記錄檔與 屬性所 Log 指定的記錄檔產生關聯。 如果記錄檔不存在 (且指定來源) , Install 請建立記錄,並將新來源與其產生關聯。
一般而言,您不會從程式碼中呼叫 的方法 EventLogInstaller ;它們通常只會由 Installutil.exe (Installer Tool) 呼叫。 此工具會在安裝程式期間自動呼叫 Install 方法,以寫入與所安裝事件記錄檔相關聯的登錄資訊。 安裝是交易式的,因此,如果在安裝期間發生任何安裝專案元件的失敗,所有先前安裝的元件都會回復到其安裝前狀態。 這是藉由呼叫每個元件的 Rollback 方法來完成。
使用 EventLogInstaller 來註冊新或現有事件記錄檔的新來源;請勿使用 EventLogInstaller 來變更現有的來源。 類別 EventLogInstaller 不會修改現有來源的組態屬性,以符合指定的安裝屬性。 如果 Source 屬性符合電腦上針對不同事件記錄檔註冊的來源名稱,則 Install 方法會擲回例外狀況。 如果 Source 屬性符合已在 屬性中指定的相同事件記錄檔註冊 Log 的來源名稱,則 Install 方法會略過註冊來源。
應用程式的安裝常式會使用專案安裝程式的 Installer.Context 屬性,自動維護已安裝元件的相關資訊。 當工具安裝每個 EventLogInstaller 時,會持續更新傳遞至 Install 做為 stateSaver
參數的狀態資訊。 通常,您的程式碼不需要明確修改此狀態資訊。