ioCode.Logging
1.0.0
dotnet add package ioCode.Logging --version 1.0.0
NuGet\Install-Package ioCode.Logging -Version 1.0.0
<PackageReference Include="ioCode.Logging" Version="1.0.0" />
paket add ioCode.Logging --version 1.0.0
#r "nuget: ioCode.Logging, 1.0.0"
// Install ioCode.Logging as a Cake Addin #addin nuget:?package=ioCode.Logging&version=1.0.0 // Install ioCode.Logging as a Cake Tool #tool nuget:?package=ioCode.Logging&version=1.0.0
ioCode.Logging
It is the C# library that helps to keep the errors, warnings and notifications experienced during the runtime of your applications in the log file.
Classes
ioCode.Logging library contains the following classes.
- Logger Common class used to write messages to log file. It allows basic settings such as target root folder and target file name.
- LogNotification It is the class that writes "Notification" messages to the log file.
- LogWarning It is the class that writes "Warning" messages to the log file.
- LogError It is the class that writes "Error" messages to the log file.
- LogDebug It is the class that writes "Debug" messages to the log file.
How to use
Write to log file
.
.
.
using ioCode.Logging;
static class Program
{
/// <summary>
/// The main entry point for the application.
/// </summary>
[STAThread]
static void Main()
{
// Initial settings
Logger.Current.RootDirectoryPath = @"C:\users\[current_user]\documents"; // must be exists
Logger.Current.FileNameFormat = @".\TestLogs\${yyyy}\${MMMM}\ioCodeLogging_${yyyyMMdd}.log";
Logger.Current.LogLevel = LogLevels.All;
new LogNotification().WriteLine("notification message");
new LogWarning().WriteLine("warning message");
new LogError().WriteLine("error message");
new LogDebug().WriteLine("debug message");
}
}
The library automatically creates all subdirectories specified by the "FileNameFormat" property. In the example above, a new log file is created for each day based on the local date.
The file content will be as follows.
#
# [LOG_TYPES]
# [N]: Notification
# [W]: Warning
# [E]: Error
# [D]: Debug
# Log Line Format: 'yyyy-MM-ddTHH:mm:ss.fffzzz [THREAD_ID] [LOG_TYPES] LOG_MESSAGE - MEMBER_NAME(FILE_NAME[Ln:LINE])'
#
2022-05-05T12:58:22.610+03:00 [0x00000001] [N] notification message
2022-05-05T12:58:22.616+03:00 [0x00000001] [W] warning message - Main(Program.cs[Ln:24])
2022-05-05T12:58:22.617+03:00 [0x00000001] [E] error message - Main(Program.cs[Ln:25])
2022-05-05T12:58:22.617+03:00 [0x00000001] [D] debug message - Main(Program.cs[Ln:26])
Delete Expired Files
A timeout period can be set for files stored on the local disk. The following example deletes log files older than 7 days from local disk.
// Initial settings
Logger.Current.LifetimeInDays = 7;
Logger.Current.DeleteExpiredFiles = true;
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
This package has no dependencies.
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 |
---|---|---|
1.0.0 | 254 | 5/5/2022 |