System.Diagnostics.EventLog 8.0.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package System.Diagnostics.EventLog --version 8.0.0
NuGet\Install-Package System.Diagnostics.EventLog -Version 8.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="System.Diagnostics.EventLog" Version="8.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add System.Diagnostics.EventLog --version 8.0.0
#r "nuget: System.Diagnostics.EventLog, 8.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install System.Diagnostics.EventLog as a Cake Addin
#addin nuget:?package=System.Diagnostics.EventLog&version=8.0.0

// Install System.Diagnostics.EventLog as a Cake Tool
#tool nuget:?package=System.Diagnostics.EventLog&version=8.0.0

About

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

  • 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

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

Main Types

The main types provided by this library are:

Under the System.Diagnostics namespace, the main types are:

Under the System.Diagnostics.Eventing.Reader namespace, the main types are:

Additional Documentation

Feedback & Contributing

System.Diagnostics.EventLog is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (155)

Showing the top 5 NuGet packages that depend on System.Diagnostics.EventLog:

Package Downloads
System.Configuration.ConfigurationManager The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides types that support using XML configuration files (app.config). This package exists only to support migrating existing .NET Framework code that already uses System.Configuration. When writing new code, use another configuration system instead, such as Microsoft.Extensions.Configuration.

Castle.Core The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Castle Core, including DynamicProxy, Logging Abstractions and DictionaryAdapter

Microsoft.Extensions.Logging.EventLog The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Windows Event Log logger provider implementation for Microsoft.Extensions.Logging.

System.ServiceProcess.ServiceController The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides the System.ServiceProcess.ServiceController class, which allows you to connect to a Windows service, manipulate it, or get information about it. Commonly Used Types: System.ServiceProcess.ServiceController System.ServiceProcess.ServiceControllerStatus System.ServiceProcess.ServiceType

Microsoft.Windows.Compatibility The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

This Windows Compatibility Pack provides access to APIs that were previously available only for .NET Framework. It can be used from both .NET as well as .NET Standard.

GitHub repositories (31)

Showing the top 5 popular GitHub repositories that depend on System.Diagnostics.EventLog:

Repository Stars
PowerShell/PowerShell
PowerShell for every system!
dotnet/wpf
WPF is a .NET Core UI framework for building Windows desktop applications.
NLog/NLog
NLog - Advanced and Structured Logging for Various .NET Platforms
microsoft/WPF-Samples
Repository for WPF related samples
dotnet/corert
This repo contains CoreRT, an experimental .NET Core runtime optimized for AOT (ahead of time compilation) scenarios, with the accompanying compiler toolchain.
Version Downloads Last updated
9.0.0-preview.5.24306.7 6,884 6/11/2024
9.0.0-preview.4.24266.19 13,417 5/21/2024
9.0.0-preview.3.24172.9 50,939 4/11/2024
9.0.0-preview.2.24128.5 19,591 3/12/2024
9.0.0-preview.1.24080.9 47,949 2/13/2024
8.0.0 36,577,015 11/14/2023
8.0.0-rc.2.23479.6 201,728 10/10/2023
8.0.0-rc.1.23419.4 145,080 9/12/2023
8.0.0-preview.7.23375.6 73,230 8/8/2023
8.0.0-preview.6.23329.7 74,640 7/11/2023
8.0.0-preview.5.23280.8 45,068 6/13/2023
8.0.0-preview.4.23259.5 174,775 5/16/2023
8.0.0-preview.3.23174.8 102,755 4/11/2023
8.0.0-preview.2.23128.3 51,751 3/14/2023
8.0.0-preview.1.23110.8 97,434 2/21/2023
7.0.0 74,648,599 11/7/2022
7.0.0-rc.2.22472.3 185,693 10/11/2022
7.0.0-rc.1.22426.10 132,773 9/14/2022
7.0.0-preview.7.22375.6 63,925 8/9/2022
7.0.0-preview.6.22324.4 39,135 7/12/2022
7.0.0-preview.5.22301.12 39,903 6/14/2022
7.0.0-preview.4.22229.4 47,005 5/10/2022
7.0.0-preview.3.22175.4 39,935 4/13/2022
7.0.0-preview.2.22152.2 24,052 3/14/2022
7.0.0-preview.1.22076.8 23,448 2/17/2022
6.0.0 270,076,088 11/8/2021
6.0.0-rc.2.21480.5 358,576 10/12/2021
6.0.0-rc.1.21451.13 259,449 9/14/2021
6.0.0-preview.7.21377.19 120,919 8/10/2021
6.0.0-preview.6.21352.12 48,761 7/14/2021
6.0.0-preview.5.21301.5 33,372 6/15/2021
6.0.0-preview.4.21253.7 35,685 5/24/2021
6.0.0-preview.3.21201.4 38,386 4/8/2021
6.0.0-preview.2.21154.6 74,662 3/11/2021
6.0.0-preview.1.21102.12 42,997 2/12/2021
5.0.1 7,961,027 2/9/2021
5.0.0 94,867,516 11/9/2020
5.0.0-rc.2.20475.5 84,475 10/13/2020
5.0.0-rc.1.20451.14 59,841 9/14/2020
5.0.0-preview.8.20407.11 30,642 8/25/2020
5.0.0-preview.7.20364.11 42,371 7/21/2020
5.0.0-preview.6.20305.6 31,596 6/25/2020
5.0.0-preview.5.20278.1 15,032 6/10/2020
5.0.0-preview.4.20251.6 34,490 5/18/2020
5.0.0-preview.3.20214.6 56,360 4/23/2020
5.0.0-preview.2.20160.6 60,398 4/2/2020
5.0.0-preview.1.20120.5 20,062 3/16/2020
4.7.0 117,314,256 12/3/2019
4.7.0-preview3.19551.4 18,059 11/13/2019
4.7.0-preview2.19523.17 17,366 11/1/2019
4.7.0-preview1.19504.10 19,299 10/15/2019
4.6.0 18,171,257 9/23/2019
4.6.0-rc1.19456.4 74,488 9/16/2019
4.6.0-preview9.19421.4 31,169 9/4/2019
4.6.0-preview9.19416.11 560 9/4/2019
4.6.0-preview8.19405.3 66,179 8/13/2019
4.6.0-preview7.19362.9 38,319 7/23/2019
4.6.0-preview6.19303.8 72,555 6/12/2019
4.6.0-preview6.19264.9 576 9/4/2019
4.6.0-preview5.19224.8 32,345 5/6/2019
4.6.0-preview4.19212.13 3,852 4/18/2019
4.6.0-preview3.19128.7 9,887 3/6/2019
4.6.0-preview.19073.11 18,902 1/29/2019
4.6.0-preview.18571.3 16,189 12/3/2018
4.5.0 32,211,381 5/29/2018
4.5.0-rc1 64,130 5/6/2018
4.5.0-preview2-26406-04 28,953 4/10/2018
4.5.0-preview1-26216-02 36,796 2/26/2018
4.5.0-preview1-25914-04 299,949 11/15/2017