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方法會拋出例外。 Install若Source該屬性與已註冊於該屬性指定Log事件日誌的來源名稱相符，該方法不會註冊來源。

欲了解事件日誌與來源行為的更詳細資訊，請參閱 EventLog 類別文件 Log 中的 與 Source 屬性。

另請參閱

• Source
• EventLog