Dignus.Extensions.Logging 3.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. .NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher. .NET Framework 4.8 This package targets .NET Framework 4.8. The package is compatible with this framework or higher. 
dotnet add package Dignus.Extensions.Logging --version 3.0.0
                    


                    

                
NuGet\Install-Package Dignus.Extensions.Logging -Version 3.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="Dignus.Extensions.Logging" Version="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Dignus.Extensions.Logging" Version="3.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Dignus.Extensions.Logging" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Dignus.Extensions.Logging --version 3.0.0
                    


                    

                
#r "nuget: Dignus.Extensions.Logging, 3.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. 
#:package Dignus.Extensions.Logging@3.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Dignus.Extensions.Logging&version=3.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Dignus.Extensions.Logging&version=3.0.0
                    


                            Install as a Cake Tool

Dignus.Extensions.Logging

Integration module connecting Dignus.Log with Microsoft.Extensions.Logging.
Provides a lightweight logging bridge that enables seamless use of Dignus’ logger
within the standard ASP.NET Core and .NET logging infrastructure.

Features

Feature Description
ASP.NET Core Integration Enables Dignus logging through the ILogger interface and ILoggerFactory.
Category Support Adds log category support (${category}) for structured log output.
Scope Handling Accepts BeginScope() values through IExternalScopeProvider; arbitrary scope values are not included in output by default.
Automatic Registration AddDignusLog() extension method integrates logging and configuration automatically.

Core APIs

API Purpose
AddDignusLog(this IServiceCollection services, LogConfiguration logConfiguration) Registers the Dignus logging provider and builds the log configuration with LogBuilder, so do not call LogBuilder.Build() separately.
AddDignusLog(this IServiceCollection services, LogConfiguration logConfiguration, string loggerName) Same as above, but routes .NET log events to the Dignus logger with that name instead of the default logger.
DignusLoggerProvider Implements ILoggerProvider to route .NET log events into the Dignus logger. Disposing the provider does not dispose that logger; LogManager.Dispose() does.

Example

using Dignus.Extensions.Logging;
using Dignus.Log;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;

var services = new ServiceCollection();

// Load Dignus logging configuration
var logConfiguration = LogConfigXmlReader.Load("log.config");

// Integrate with Microsoft.Extensions.Logging
services.AddLogging(loggingBuilder =>
{
    loggingBuilder.ClearProviders();
    loggingBuilder.Services.AddDignusLog(logConfiguration);
});

var serviceProvider = services.BuildServiceProvider();
var applicationLogger = serviceProvider.GetRequiredService<ILogger<Program>>();

applicationLogger.LogInformation("Hello from Dignus Logging!");

With the default overload, the provider writes through the default logger, which is named after the entry assembly. Leave loggerName empty or omit it on the XML <logger> element to attach targets to that logger.

Design Principles

  • Category Awareness: Extends LogEvent to include category metadata for structured logging.
  • Optimized Formatting: Uses cached delegates for element rendering to minimize overhead.
  • Full .NET Integration: Works natively with ASP.NET Core’s logging pipeline.
  • Scoped Logging Support: Accepts BeginScope() values; arbitrary scope values are not rendered by default.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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 was computed.  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.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net48 is compatible.  net481 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen 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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0 111 10/26/2026
2.0.2 94 10/21/2026
2.0.1 92 10/19/2026
2.0.0 110 10/15/2026
1.0.15 94 10/15/2026
1.0.14 115 9/14/2026
1.0.13 148 6/24/2026
1.0.12 137 5/8/2026
1.0.11 120 4/25/2026
1.0.10 141 2/21/2026
1.0.9 462 12/11/2025
1.0.8 201 11/23/2025
1.0.7 274 11/22/2025
1.0.6 438 11/19/2025
1.0.5 198 11/2/2025
1.0.3 243 10/30/2025
1.0.2 233 10/29/2025
1.0.1 225 10/28/2025
1.0.0 230 10/28/2025