Class ServiceCollectionExtensions

Provides extension methods for Serilog ILogger instances to enhance logging capabilities.

Inheritance

object

ServiceCollectionExtensions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Coree.NETStandard.Serilog

Assembly: Coree.NETStandard.dll

Syntax

public static class ServiceCollectionExtensions

Methods

AddLoggingCoreeNETStandard(IServiceCollection, bool, Dictionary<string, LogEventLevel>?)

Adds and configures Serilog logging to the specified IServiceCollection, incorporating a conditional log level feature.

Declaration

public static IServiceCollection AddLoggingCoreeNETStandard(this IServiceCollection services, bool simplifyNamespace = true, Dictionary<string, LogEventLevel>? conditionalLevel = null)

Parameters

Type	Name	Description
IServiceCollection	services	The IServiceCollection to which logging services are added.
bool	simplifyNamespace	If true, simplifies the namespace to only include the last component.
Dictionary<string, LogEventLevel>	conditionalLevel	An optional dictionary mapping source contexts to LogEventLevels, allowing for dynamic log level overrides. Example usage: new Dictionary<string, LogEventLevel> { ["Coree.SomeService"] = LogEventLevel.Debug, }; This parameter enables conditional log level adjustment based on the source context, offering fine-grained control over log verbosity without direct reference to the source contexts at runtime.

Returns

Type	Description
IServiceCollection	The original IServiceCollection, supporting method chaining.

Remarks

Configures Serilog as the primary logging provider, leveraging a LoggingLevelSwitch for default level control. It enriches log entries with contextual information and enables output to both console and debug sinks, using a concise output format. This setup ensures that logs are both informative and manageable, tailored to development and production environments.

ForMethodContext(ILogger)

Configures the logger to associate the calling method's name with log events as the source context.

Declaration

public static ILogger ForMethodContext(this ILogger logger)

Parameters

Type	Name	Description
ILogger	logger	The Serilog ILogger instance to configure.

Returns

Type	Description
ILogger	A new ILogger instance that includes the source context set to the calling method's name.

ForSourceContext(ILogger, string)

Configures the logger to associate a specified source context with log events.

Declaration

public static ILogger ForSourceContext(this ILogger logger, string value)

Parameters

Type	Name	Description
ILogger	logger	The Serilog ILogger instance to configure.
string	value	The value to set for the SourceContext property in the log context.

Returns

Type	Description
ILogger	A new ILogger instance that includes the specified source context.

Examples

Here is how you can use the ForSourceContext method:

var logger = Log.Logger;
var contextualLogger = logger.ForSourceContext("MyApplication.Component");
contextualLogger.Information("This is an informational message with a source context.");