Interface ILogger
Base interface for SDK loggers.
Namespace: StylelabsStylelabs.MSdkStylelabs.M.Sdk.ContractsLogging
Assembly: Stylelabs.M.Sdk.dll
Syntax
public interface ILoggerRemarks
Performance tips:
- For static or constant strings, construct and pass the string directly.
- For dynamic strings that require IO, make sure to pass a to the logger.
- It is recommended to always pass a for debugging messages. This way, when debugging is disabled, the debug calls will have virtually no overhead. If you construct and pass strings directly, it will always have more overhead.
Properties
IsDebugEnabled
Gets a value indicating whether debug-level logging is enabled.
Declaration
bool IsDebugEnabled { get; }Property Value
| Type | Description |
|---|---|
| bool |
IsErrorEnabled
Gets a value indicating whether error-level logging is enabled.
Declaration
bool IsErrorEnabled { get; }Property Value
| Type | Description |
|---|---|
| bool |
IsInfoEnabled
Gets a value indicating whether info-level logging is enabled.
Declaration
bool IsInfoEnabled { get; }Property Value
| Type | Description |
|---|---|
| bool |
IsWarnEnabled
Gets a value indicating whether warning-level logging is enabled.
Declaration
bool IsWarnEnabled { get; }Property Value
| Type | Description |
|---|---|
| bool |
MinimumLogLevel
Gets or sets the minimum enabled log level.
Declaration
LogLevel MinimumLogLevel { get; set; }Property Value
| Type | Description |
|---|---|
| LogLevel |
Methods
Debug(Func<string>)
Logs debug-level information.
Declaration
void Debug(Func<string> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>string | message |
Function that generates the log message. |
Debug(string)
Logs debug-level information.
Declaration
void Debug(string message)Parameters
| Type | Name | Description |
|---|---|---|
| string | message |
Message to log. |
DebugAsync(Func<Task<string>>)
Async version of Debug(Func<string>).
Declaration
Task DebugAsync(Func<Task<string>> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>Task<>string | message |
Message to log. |
Returns
| Type | Description |
|---|---|
| Task |
A representing the asynchronous operation. |
Error(Exception)
Logs error-level information.
Declaration
void Error(Exception exception)Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception |
The exception that occurred. |
Error(Func<string>, Exception)
Logs error-level information.
Declaration
void Error(Func<string> message, Exception exception = null)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>string | message |
Function that generates the log message. |
| Exception | exception |
The exception that occurred. |
Error(string, Exception)
Logs error-level information.
Declaration
void Error(string message, Exception exception = null)Parameters
| Type | Name | Description |
|---|---|---|
| string | message |
Message to log. |
| Exception | exception |
The exception that occurred. |
ErrorAsync(Func<Task<string>>, Exception)
Async version of Error(Func<string>, Exception).
Declaration
Task ErrorAsync(Func<Task<string>> message, Exception exception = null)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>Task<>string | message |
Function that generates the log message. |
| Exception | exception |
The exception that occurred. |
Returns
| Type | Description |
|---|---|
| Task |
A representing the asynchronous operation. |
Info(Func<string>)
Logs info-level information.
Declaration
void Info(Func<string> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>string | message |
Function that generates the log message. |
Info(string)
Logs info-level information.
Declaration
void Info(string message)Parameters
| Type | Name | Description |
|---|---|---|
| string | message |
Message to log. |
InfoAsync(Func<Task<string>>)
Async version of Info(Func<string>).
Declaration
Task InfoAsync(Func<Task<string>> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>Task<>string | message |
Function that generates the log message. |
Returns
| Type | Description |
|---|---|
| Task |
A representing the asynchronous operation. |
Warn(Func<string>)
Logs warning-level information.
Declaration
void Warn(Func<string> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>string | message |
Function that generates the log message. |
Warn(string)
Logs warning-level information.
Declaration
void Warn(string message)Parameters
| Type | Name | Description |
|---|---|---|
| string | message |
Message to log. |
WarnAsync(Func<Task<string>>)
Async version of Warn(Func<string>).
Declaration
Task WarnAsync(Func<Task<string>> message)Parameters
| Type | Name | Description |
|---|---|---|
| Func<>Task<>string | message |
Function that generates the log message. |
Returns
| Type | Description |
|---|---|
| Task |
A representing the asynchronous operation. |
Events
OnLog
Fires an event just before something is about to be logged.
Declaration
event EventHandler<LogEventArgs> OnLogEvent Type
| Type | Description |
|---|---|
| EventHandler<>LogEventArgs |