EventLog.Entries EventLog.Entries EventLog.Entries EventLog.Entries Property

Definition

Gets the contents of the event log.

public:
 property System::Diagnostics::EventLogEntryCollection ^ Entries { System::Diagnostics::EventLogEntryCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Diagnostics.EventLogEntryCollection Entries { get; }
member this.Entries : System.Diagnostics.EventLogEntryCollection
Public ReadOnly Property Entries As EventLogEntryCollection

Property Value

An EventLogEntryCollection holding the entries in the event log. Each entry is associated with an instance of the EventLogEntry class.

Examples

The following example reads entries in the event log, "MyNewLog", on the local computer.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myLog = gcnew EventLog;
   myLog->Log = "MyNewLog";
   System::Collections::IEnumerator^ myEnum = myLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

using System;
using System.Diagnostics;
              
class MySample{

    public static void Main(){

        EventLog myLog = new EventLog();
        myLog.Log = "MyNewLog";                      
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }    
    }       
}
   
Option Strict
Option Explicit

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        Dim myLog As New EventLog()
        myLog.Log = "MyNewLog"
        Dim entry As EventLogEntry
        For Each entry In  myLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub ' Main
End Class ' MySample

Remarks

Use the Entries member when reading from the event log.

Because the property is read-only, you cannot modify an entry or write to the log using Entries. Instead, specify a Source and call WriteEntry to write a new log entry. You can use Entries to count the number of entries in the event log, and view each EventLogEntry in the collection. Use the indexed Item[Int32] member to retrieve information about a specific entry, such as Message, Category, TimeWritten, or EntryType.

It is not necessary to specify a Source when only reading from a log. You can specify only the Log name and MachineName (server computer name) properties for the EventLog instance. In either case, the Entries member is automatically populated with the event log's list of entries. You can select the appropriate index for an item in this list to read individual entries.

An important distinction between reading and writing log entries is that it is not necessary to explicitly call a read method. After the Log and MachineName are specified, the Entries property is automatically populated. If you change the value of the Log or MachineName property, the Entries property is repopulated the next time you read it.

Note

You are not required to specify the MachineName if you are connecting to a log. If you do not specify the MachineName, the local computer, ".", is assumed.

Security

EventLogPermission
for administering event log information on the computer. Associated enumeration: Administer

Applies to

See also