EventLog 程式設計架構

更新：2007 年 11 月

EventLog 元件會使用 .NET Framework 命名空間的這些部分：

EventLog 命名空間

當您在 Visual Studio 中將 EventLog 元件的執行個體加入至應用程式時，系統會自動建立參考，並匯入在存取命名空間及類別時所需的陳述式。不過，假如您是在程式碼或 Microsoft .NET Framework 中建立 EventLog 元件，則需建立 System.Diagnostics 的參考，並在匯入相同程式庫的專案中加入陳述式。

如需加入和移除專案參考的指示，請參閱 HOW TO：在 Visual Studio 中新增或移除參考 (Visual Basic)。

EventLog 類別中的重要程式設計項目

每當項目寫入到您正在檢視的記錄檔時，EventLog 元件就會引發一個稱為 EntryWritten 的事件。您可以為這個事件定義一個處理程式。此外，您可以藉由下列方法和 EventLog 元件執行個體產生互動：

• 您可以藉由 Exists 方法判斷特定事件記錄檔是否存在。

• 您可以使用 CreateEventSource 方法來定義會在事件來源與記錄檔之間產生關聯性的字串，並使用 DeleteEventSource 方法來移除此關聯。您也可以藉由這個方法來建立新的自訂事件記錄檔。只要輸入新的記錄檔名稱當成您想要建立來源的記錄檔，系統就會自動建立此記錄檔。

  注意事項：
  您可以將 Source 屬性設定為任何字串，而它不必對應至您的應用程式名稱。單一應用程式可以包含很多個使用不同來源字串以讓事件記錄檔識別它們的元件。

• 可以使用 WriteEntry 方法將事件資訊寫入任何您有權存取的事件記錄檔。如果元件或應用程式尚未使用指定的記錄檔登錄，則 WriteEntry 方法會自動將其登錄為有效來源。

• 您可以使用 SourceExists 方法來判斷特定來源是否已經登錄。這個方法在您於指定電腦上建立一個新來源時特別有用，因為假使該電腦上已登錄過該來源，SourceExists 方法就會造成一個執行階段錯誤。

• 您可以使用 GetEventLogs 方法來擷取特定電腦上所有事件記錄檔的清單。

• 您可以使用 Delete 方法來刪除一整個事件記錄檔。使用這個方法時請特別小心，因為在您刪除記錄檔時，也會刪除登錄在內的任何來源。

請參閱

概念

EventLog 元件的簡介