dotnetframework/System.Diagnostics.EventLogv9.0.13
✓ Verified.NET FW4.6.2.NET 10.0.NET 11.0.NET Std2.0
Provides the System.Diagnostics.EventLog class, which allows the applications to use the Windows event log service. Commonly Used Types: System.Diagnostics.EventLog
Get Started
$ dotnet add package System.Diagnostics.EventLogReadme
About
<!-- A description of the package and where one can find more documentation -->This package provides types that allow applications to interact with the Windows Event Log service.
When an error occurs in a Windows machine, the system administrator or support representative must determine what caused the error, attempt to recover any lost data, and prevent the error from recurring. It is helpful if applications, the operating system, and other system services record important events, such as low-memory conditions or excessive attempts to access a disk. The system administrator can then use the Windows Event Log to help determine what conditions caused the error and identify the context in which it occurred.
Key Features
<!-- The key features of this package -->- Allows reading from existing logs.
- Allows writing entries to logs.
- Can create or delete event sources.
- Can delete logs.
- Can respond to log entries.
- Can create new logs when creating an event source.
How to Use
<!-- A compelling example on how to use this package with code, as well as any specific guidelines for when to use the package -->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("Event source created. 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;
}
EventLog myLog = new();
myLog.Source = "MySource";
myLog.WriteEntry("Writing an informational entry to the event log.");
Notes:
- This assembly is only supported on Windows operating systems.
- Starting with Windows Vista, you must run the application as an administrator to interact with the Windows Event Log service using the
System.Diagnostics.EventLogclass.