EventLogInstaller.Install(IDictionary) 方法

定義

執行安裝,並將事件記錄檔資訊寫入至登錄。

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 參數的狀態資訊。 通常,您的程式碼不需要明確修改此狀態資訊。

適用於

另請參閱