EventLogInstaller.Install(IDictionary) 方法

定義

命名空間:

System.Diagnostics

組件:

System.Configuration.Install.dll

執行安裝並將事件日誌資訊寫入登錄檔。

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 來儲存執行回滾或卸載操作所需的資訊。

例外狀況

ArgumentException

物業中 Source 指定的名稱已經註冊在另一個事件日誌中。

備註

此 Install 方法將事件日誌資訊寫入登錄檔，並將事件日誌與屬性指定的 Log 日誌關聯起來。 如果該日誌尚未存在（且已指定來源）， Install 則建立日誌並將新來源與之關聯。

通常，你不會在程式碼中呼叫 的方法 EventLogInstaller ;它們通常只會由 Installutil.exe（安裝工具）呼叫。 該工具會在安裝過程中自動呼叫該 Install 方法，撰寫與所安裝事件日誌相關的登錄資訊。 安裝為交易性，若安裝過程中任何安裝專案元件失敗，所有先前安裝的元件會回滾至安裝前狀態。 這是透過呼叫每個元件的方法 Rollback 來達成的。

請使用 EventLogInstaller 以註冊新的或現有事件日誌的新來源;請勿使用 EventLogInstaller 來更改現有的來源。 該 EventLogInstaller 類別不會修改現有來源的設定屬性以符合指定的安裝屬性。 如果該Source屬性與電腦中註冊的不同事件日誌的來源名稱相符，該Install方法會拋出例外。 若Source該屬性與已註冊的來源名稱相符，且該來源名稱已註冊於該Log屬性中指定的同一事件日誌，此Install方法會跳過註冊來源。

應用程式的安裝例程會利用專案安裝程式的 Installer.Context 屬性自動維護已安裝元件的資訊。 這些狀態資訊作為參數傳遞給 InstallstateSaver ，並隨著工具安裝每個 EventLogInstaller。 通常，你的程式碼不需要明確修改這些狀態資訊。

另請參閱

• Rollback(IDictionary)
• Uninstall(IDictionary)
• IDictionary