EventLogEntry EventLogEntry EventLogEntry EventLogEntry Class


將單一資料錄封裝於事件記錄檔中。Encapsulates a single record in the event log. 這個類別無法被繼承。This class cannot be inherited.

public ref class EventLogEntry sealed : System::ComponentModel::Component, System::Runtime::Serialization::ISerializable
public sealed class EventLogEntry : System.ComponentModel.Component, System.Runtime.Serialization.ISerializable
type EventLogEntry = class
    inherit Component
    interface ISerializable
Public NotInheritable Class EventLogEntry
Inherits Component
Implements ISerializable


下列程式碼範例示範使用EventLogEntry類別。The following code example demonstrates the use of the EventLogEntry class. 在此範例中,switch陳述式會使用主控台輸入來搜尋指定的事件類型的事件記錄檔項目。In this example, a switch statement uses console input to search for event log entries for the specified event type. 如果找到相符項目,則記錄項目來源資訊會顯示在主控台中。If a match is found, log entry source information is displayed at the console.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;

int main()
   String^ myEventType = nullptr;
   // Associate the instance of 'EventLog' with local System Log.
   EventLog^ myEventLog = gcnew EventLog( "System","." );
   Console::WriteLine( "1:Error" );
   Console::WriteLine( "2:Information" );
   Console::WriteLine( "3:Warning" );
   Console::WriteLine( "Select the Event Type" );
   int myOption = Convert::ToInt32( Console::ReadLine() );
   switch ( myOption )
      case 1:
         myEventType = "Error";

      case 2:
         myEventType = "Information";

      case 3:
         myEventType = "Warning";

   EventLogEntryCollection^ myLogEntryCollection = myEventLog->Entries;
   int myCount = myLogEntryCollection->Count;
   // Iterate through all 'EventLogEntry' instances in 'EventLog'.
   for ( int i = myCount - 1; i > -1; i-- )
      EventLogEntry^ myLogEntry = myLogEntryCollection[ i ];
      // Select the entry having desired EventType.
      if ( myLogEntry->EntryType.Equals( myEventType ) )
         // Display Source of the event.
         Console::WriteLine( "{0} was the source of last event of type {1}", myLogEntry->Source, myLogEntry->EntryType );
         return 0;
using System;
using System.Diagnostics;
   class MyEventlogClass
      public static void Main()
         String myEventType=null;
         // Associate the instance of 'EventLog' with local System Log.
         EventLog myEventLog = new EventLog("System", ".");
         Console.WriteLine("Select the Event Type");
         int myOption=Convert.ToInt32(Console.ReadLine());
            case 1:  myEventType="Error";
            case 2:  myEventType="Information";
            case 3:  myEventType="Warning";
            default: break;

            EventLogEntryCollection myLogEntryCollection=myEventLog.Entries;
            int myCount =myLogEntryCollection.Count;
            // Iterate through all 'EventLogEntry' instances in 'EventLog'.
            for(int i=myCount-1;i>-1;i--)
               EventLogEntry myLogEntry = myLogEntryCollection[i];
               // Select the entry having desired EventType.
                  // Display Source of the event.
                     +" was the source of last event of type "

Imports System.Diagnostics

Class MyEventlogClass
   Public Shared Sub Main()
      Dim myEventType As String = Nothing
      ' Associate the instance of 'EventLog' with local System Log.
      Dim myEventLog As New EventLog("System", ".")
      Console.WriteLine("Select the Event Type")
      Dim myOption As Integer = Convert.ToInt32(Console.ReadLine())
      Select Case myOption
         Case 1
            myEventType = "Error"
         Case 2
            myEventType = "Information"
         Case 3
            myEventType = "Warning"
         Case Else
      End Select

      Dim myLogEntryCollection As EventLogEntryCollection = myEventLog.Entries
      Dim myCount As Integer = myLogEntryCollection.Count
      ' Iterate through all 'EventLogEntry' instances in 'EventLog'.
      Dim i As Integer
      For i = myCount - 1 To 0 Step -1
         Dim myLogEntry As EventLogEntry = myLogEntryCollection(i)
         ' Select the entry having desired EventType.
         If myLogEntry.EntryType.ToString().Equals(myEventType) Then
            ' Display Source of the event.
            Console.WriteLine(myLogEntry.Source + " was the source of last "& _
                             "event of type " & myLogEntry.EntryType.ToString())
         End If
   End Sub
End Class


您通常不會建立的執行個體EventLogEntry直接使用時EventLog類別。You usually will not create instances of EventLogEntry directly when working with the EventLog class. Entries隸屬EventLog類別包含的集合EventLogEntry執行個體,使用讀取時,您重複處理EventLogEntryCollection.Item[Int32]類別的索引成員。The Entries member of the EventLog class contains a collection of EventLogEntry instances, which you iterate over when reading by using the EventLogEntryCollection.Item[Int32] class index member.


此類型會實作IDisposable介面。This type implements the IDisposable interface. 當您完成使用型別時,您應該處置它直接或間接。When you have finished using the type, you should dispose of it either directly or indirectly. 若要直接處置型別,呼叫其Dispose方法中的try / catch區塊。To dispose of the type directly, call its Dispose method in a try/catch block. 若要處置它間接,使用的語言建構這類using(在 C# 中) 或Using(在 Visual Basic)。To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 如需詳細資訊,請參閱 「 使用物件,實作 IDisposable 」 一節IDisposable介面 > 主題。For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.


CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

取得值,指出元件是否能引發事件。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Category Category Category Category

取得與這個項目的 CategoryNumber 屬性關聯的文字。Gets the text associated with the CategoryNumber property for this entry.

CategoryNumber CategoryNumber CategoryNumber CategoryNumber

取得事件記錄檔項目的分類編號。Gets the category number of the event log entry.

Container Container Container Container

取得包含 IContainerComponentGets the IContainer that contains the Component.

(Inherited from Component)
Data Data Data Data

取得與項目相關聯的二進位資料。Gets the binary data associated with the entry.

DesignMode DesignMode DesignMode DesignMode

取得值,指出 Component 目前是否處於設計模式。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
EntryType EntryType EntryType EntryType

取得這個項目的事件型別。Gets the event type of this entry.

EventID EventID EventID EventID

取得目前事件項目的應用程式特定事件識別項。Gets the application-specific event identifier for the current event entry.

Events Events Events Events

取得附加在這個 Component 上的事件處理常式清單。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Index Index Index Index

取得在事件記錄檔中這個項目的索引。Gets the index of this entry in the event log.

InstanceId InstanceId InstanceId InstanceId

取得資源識別項,指定事件項目的訊息文字。Gets the resource identifier that designates the message text of the event entry.

MachineName MachineName MachineName MachineName

取得產生這個項目的電腦名稱。Gets the name of the computer on which this entry was generated.

Message Message Message Message

取得與這個事件項目相關聯的當地語系化的訊息。Gets the localized message associated with this event entry.

ReplacementStrings ReplacementStrings ReplacementStrings ReplacementStrings

取得與事件記錄檔項目相關聯的取代字串。Gets the replacement strings associated with the event log entry.

Site Site Site Site

取得或設定 ComponentISiteGets or sets the ISite of the Component.

(Inherited from Component)
Source Source Source Source

取得產生這個事件的應用程式名稱。Gets the name of the application that generated this event.

TimeGenerated TimeGenerated TimeGenerated TimeGenerated

取得這個事件產生的本地時間。Gets the local time at which this event was generated.

TimeWritten TimeWritten TimeWritten TimeWritten

取得將這個事件寫入記錄檔的本地時間。Gets the local time at which this event was written to the log.

UserName UserName UserName UserName

取得為這個事件負責的使用者名稱。Gets the name of the user who is responsible for this event.


CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

釋放 Component 所使用的所有資源。Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

釋放 Component 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(EventLogEntry) Equals(EventLogEntry) Equals(EventLogEntry) Equals(EventLogEntry)

在兩個事件記錄檔項目之間進行比較。Performs a comparison between two event log entries.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

傳回表示 Component 或其 Container 所提供之服務的物件。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

取得存留期服務物件,以控制這個執行個體的存留期原則。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

建立目前 MarshalByRefObject 物件的淺層複本。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

傳回任何包含 Component 名稱的 StringReturns a String containing the name of the Component, if any. 不應覆寫此方法。This method should not be overridden.

(Inherited from Component)


ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

將序列化目標物件所需的資料填入 SerializationInfoPopulates a SerializationInfo with the data needed to serialize the target object.


Disposed Disposed Disposed Disposed

當此元件由 Dispose() 方法的呼叫處置時發生。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)