EventLog 類別

定義

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

繼承

Object

MarshalByRefObject

Component

EventLog

實作

ISupportInitialize

範例

下列範例會在事件來源不存在時建立事件來源 MySource ，並將專案寫入事件記錄檔 MyNewLog 中。

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      //An event log source should not be created and immediately used.
      //There is a latency time to enable the source, it should be created
      //prior to executing the application that uses the source.
      //Execute this sample a second time to use the new source.
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

備註

EventLog 可讓您存取或自訂 Windows 事件記錄檔，以記錄重要軟體或硬體事件的相關資訊。 您可以使用 EventLog ，從現有的記錄讀取、將專案寫入記錄、建立或刪除事件來源、刪除記錄檔，以及回應記錄專案。 您也可以在建立事件來源時建立新的記錄。

除了提供個別事件記錄檔及其專案的存取權之外，類別 EventLog 還可讓您存取所有事件記錄檔的集合。 您可以使用 static 的成員 EventLog 來刪除記錄、取得記錄清單、建立或刪除來源，或判斷電腦是否已經包含特定來源。

預設事件記錄檔有三種：應用程式、系統和安全性。 安全性記錄檔是唯讀的。 您安裝的其他應用程式和服務，例如 Active Directory，可能會有額外的事件記錄檔。

使用 EventLog 類別時有安全性考慮。 EventLogEventLogPermission需要.NET Framework 2.0 和更新版本中特定動作的許可權，或.NET Framework 1.0 和 1.1 中的完整信任。 建議您 EventLogPermission 不要授與部分信任的程式碼。 您絕對不應該將任何事件記錄檔物件，包括 EventLogEntryCollection 和 EventLogEntry 物件傳遞至較不受信任的程式碼。 例如，建立 EventLog 物件、撰寫專案，然後將物件傳遞 EventLog 至部分信任的程式碼可以建立安全性問題，因為讀取和寫入事件記錄檔的能力可讓程式碼執行動作，例如在另一個應用程式的名稱中發出事件記錄檔訊息。

從 Windows Vista 開始，使用者帳戶控制 (UAC) 決定使用者的認證。 如果您是內建 Administrators 群組的成員，系統會將兩個執行階段存取語彙基元 (Token) 指派給您：標準使用者存取語彙基元及管理員存取語彙基元。 根據預設，您會屬於標準使用者角色。 若要執行存取安全性記錄的程式碼，您必須先將認證從標準使用者提升為系統管理員。 當您使用滑鼠時，您可以開啟應用程式的快捷方式功能表 (，以滑鼠右鍵按一下應用程式圖示) ，並指出您想要以系統管理員身分執行。

您可以使用 EventLog 來建立可透過伺服器事件檢視器檢視的自訂事件記錄檔。 RegisterDisplayName使用 方法，在 事件檢視器 中顯示事件記錄檔的當地語系化名稱。 ModifyOverflowPolicy使用 方法來設定事件記錄檔達到記錄大小上限時的行為。

若要從事件記錄檔讀取，請指定記錄檔名稱 (Log 屬性) 和伺服器電腦名稱稱 (MachineName 事件記錄檔的屬性。 如果您未指定伺服器電腦名稱稱，則會假設本機電腦 「.」。 不需要指定事件來源 (屬性) Source ，因為只有寫入記錄時才需要來源。 屬性 Entries 會自動填入事件記錄檔的專案清單。

若要寫入事件記錄檔，請指定或建立事件來源 (Source 屬性) 。 您必須在電腦上擁有系統管理認證，才能建立新的事件來源。 事件來源會將您的應用程式註冊為有效的專案來源事件記錄檔。 您可以使用事件來源一次只寫入一個記錄檔。 屬性 Source 可以是任何隨機字串，但名稱必須與電腦上的其他來源不同。 事件來源通常是應用程式的名稱或其他識別字串。 嘗試建立重複 Source 的值會擲回例外狀況。 不過，單一事件記錄檔可以與多個來源相關聯。

如果與實例相關聯的 EventLog 事件記錄檔事件來源不存在，則會建立新的事件來源。 若要在 Windows Vista 和更新版本或 Windows Server 2003 中建立事件來源，您必須具有系統管理認證。

這項需求是因為必須搜尋所有事件記錄檔，包括安全性記錄，才能判斷事件來源是否是唯一的。 從 Windows Vista 開始，使用者沒有存取安全性記錄的許可權;因此， SecurityException 會擲回 。

應用程式和服務應該寫入應用程式記錄檔或自訂記錄檔。 設備磁碟機應該寫入系統記錄檔。 如果您未明確設定 Log 屬性，事件記錄檔會預設為應用程式記錄檔。

WriteEvent使用 和 WriteEntry 方法，將事件寫入事件記錄檔。 您必須指定事件來源來寫入事件;您必須先建立並設定事件來源，才能使用來源撰寫第一個專案。

在安裝應用程式期間建立新的事件來源。 這可讓作業系統重新整理其已註冊事件來源及其設定的清單。 如果作業系統尚未重新整理其事件來源清單，而且您嘗試使用新來源寫入事件，則寫入作業將會失敗。 您可以使用 物件或 CreateEventSource 方法來設定新的來源 EventLogInstaller 。 您必須在電腦上擁有系統管理認證，才能建立新的事件來源。

每個來源一次只能寫入一個事件記錄檔;不過，您的應用程式可以使用多個來源來寫入多個事件記錄檔。 例如，您的應用程式可能需要針對不同的事件記錄檔或不同的資源檔設定多個來源。 若要變更現有來源的組態詳細資料，您必須刪除來源，然後使用新的組態加以建立。 如果其他應用程式或元件使用現有的來源，請使用更新的組態建立新的來源，而不是刪除現有的來源。

您可以使用事件類別目錄和訊息字串的當地語系化資源註冊事件來源。 您的應用程式可以使用資源識別碼來寫入事件記錄專案，而不是指定實際的字串值。 如需使用資源檔設定來源的詳細資訊， EventLogInstaller 請參閱 和 EventSourceCreationData 類別。

如果您的應用程式直接將字串值寫入事件記錄檔，您就不需要設定來源的資源檔案屬性。 來源必須設定為撰寫當地語系化專案，或撰寫直接字串。 如果您的應用程式同時使用資源識別碼和字串值來寫入專案，您必須註冊兩個不同的來源。 例如，使用資源檔設定一個來源，然後在 方法中使用 WriteEvent 該來源，使用資源識別碼將專案寫入事件記錄檔。 然後建立不含資源檔的不同來源，並在 方法中使用 WriteEntry 該來源直接將字串寫入事件記錄檔。

寫入事件時，您至少必須指定訊息字串或訊息字串的資源識別碼。 其他事件屬性是選擇性的。 選擇性事件設定的範例包括：

• 您可以設定 EventLogEntryType 來指定專案事件檢視器顯示的圖示。

• 如果您的應用程式使用類別來篩選事件，您可以指定事件的類別識別碼。

• 如果您想要將其他資訊與指定的事件產生關聯，您可以將二進位資料附加至事件專案。

如需 實例 EventLog 的初始屬性值清單，請參閱 建 EventLog 構函式。

建構函式

屬性

方法

事件

適用於

另請參閱

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase