Export (0) Print
Expand All

EventLog::Entries Property

Gets the contents of the event log.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)

[BrowsableAttribute(false)]
public:
property EventLogEntryCollection^ Entries {
	EventLogEntryCollection^ get ();
}

Property Value

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

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 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.

NoteNote:

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.

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 );
   }
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft