EventLog.Entries Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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; }[<System.ComponentModel.Browsable(false)>]
member this.Entries : System.Diagnostics.EventLogEntryCollectionPublic ReadOnly Property Entries As EventLogEntryCollectionProperty Value
An EventLogEntryCollection holding the entries in the event log. Each entry is associated with an instance of the EventLogEntry class.
- Attributes
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.Diagnostics
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
End Class
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[] 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.
