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 (Installer Tool) 呼叫 。 此工具會在安裝程式期間自動呼叫 Install 方法，以寫入與所安裝事件記錄檔相關聯的登錄資訊。 安裝是交易式的，因此如果安裝期間有任何安裝專案元件失敗，所有先前安裝的元件都會回復到其安裝前狀態。 這是藉由呼叫每個元件的 Rollback 方法來完成。

使用 EventLogInstaller 來為新的或現有的事件記錄檔註冊新的來源;請勿使用 EventLogInstaller 來變更現有的來源。 類別 EventLogInstaller 不會修改現有來源的組態屬性，以符合指定的安裝屬性。 如果 Source 屬性符合計算機上針對不同事件記錄檔註冊的來源名稱，方法Install會擲回例外狀況。 如果 Source 屬性符合已在 屬性中指定的Log相同事件記錄檔註冊的來源名稱，則Install方法會略過註冊來源。

應用程式的安裝例程會使用專案安裝程式的 Installer.Context 屬性，自動維護已安裝之元件的相關信息。 當工具安裝每個 EventLogInstaller時，會持續更新傳遞至 Install 作為 stateSaver 參數的這個狀態資訊。 通常，您的程式代碼不需要明確地修改此狀態資訊。

另請參閱

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