EventLogInstaller.Source 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Configuration.Install.dll

取得或設定使用記錄檔登錄的來源名稱。

public:
 property System::String ^ Source { 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 Source { get; set; }

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

Public Property Source As String

屬性值

String

使用事件記錄檔登錄作為項目來源的名稱。 預設為空字串 ("")。

屬性

TypeConverterAttribute

備註

事件來源會指出事件記錄的內容。 它通常是應用程式的名稱，或大型應用程式內的元件名稱。

安裝程式會使用 屬性的值 Source ，向事件記錄檔註冊您的應用程式，作為有效的專案來源。 新的來源名稱不符合現有的來源名稱或現有的事件記錄檔名稱。 每個來源一次只能寫入一個事件記錄檔;不過，您的應用程式可以使用多個來源來寫入多個事件記錄檔。 例如，您的應用程式可能需要針對不同的事件記錄檔或不同的資源檔案設定多個來源。

應用程式和服務應該寫入應用程式記錄檔或自定義記錄檔。 設備驅動器應該寫入系統記錄檔。 如果您在安裝程式執行之前未指定記錄檔名稱，安裝程式會將來源註冊至應用程式記錄檔。 如果您指定不存在的記錄檔名稱，系統會向該記錄檔註冊 Source ，但在寫入第一個專案之前，不會建立記錄檔。

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

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

另請參閱

• Source
• EventLog