EventLogInstaller.Log 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Configuration.Install.dll

取得或設定要將來源設定至的記錄檔名稱。

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

Public Property Log As String

屬性值

String

記錄檔的名稱。 這可以是應用程式、系統或自訂的記錄檔名稱。 預設為空字串 ("")。

屬性

TypeConverterAttribute

備註

您可以使用 屬性， Log 將您在屬性中指定的 Source 來源與本機計算機上的現有記錄檔或新的記錄檔產生關聯。 Installutil.exe (安裝程式工具) 使用此資訊，將來源對應至計算機登錄中的記錄檔。 應用程式和服務應該寫入應用程式記錄檔或自定義記錄檔。 設備驅動器應該寫入系統記錄檔。

若要將專案寫入事件記錄檔，您必須建立來源，並將其註冊至事件記錄檔。 事件來源一次只能寫入一個記錄檔。 安裝程式會使用 屬性的值 Source ，向事件記錄檔註冊您的應用程式，做為有效的專案來源。 如果您在安裝程式執行之前未指定記錄檔名稱，安裝程式會將來源註冊至應用程式記錄檔。 如果您指定新的來源和現有的記錄檔，安裝程式會建立新的事件來源，並將它與您指定的記錄產生關聯。 如果您同時指定新的來源和新的記錄檔，安裝程式會將新來源與登錄中的新記錄產生關聯，但在寫入第一個專案之前，不會建立記錄檔。

作業系統會將事件記錄檔儲存為檔案。 當您使用 EventLogInstaller 或 CreateEventSource 方法來建立新的事件記錄檔時，相關聯的檔案會儲存在指定計算機上的 %SystemRoot%\System32\Config 目錄中。 檔名是藉由附加屬性的前 Log 8 個字元加上 「.evt」 擴展名來設定。

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

如需事件記錄檔和來源行為的詳細資訊，請參閱 EventLog 和 Source 屬性的Log類別檔。

另請參閱

• Log
• EventLog