CFLog 1.1.2

CFLog C# Logger for Windows .NET 6,7,8,9

仕様等詳細はこちら(日本語)

使用方法やAPIについての詳細は上記ドキュメントを参照してください。
サンプルプログラムやxUnitプロジェクトが必要な場合は GitHub から取得してください。

仕様・コンセプト

• 業務製品開発に耐えうる品質
• １プロセスにつき１種類のログファイル
• 同一アプリを複数起動するマルチプロセスには自動サブフォルダ振分けで対応
• ログファイルの容量制限はなく、１日１ログファイルで指定保管日数を超えたファイルを削除していく方式
• アプリケーションクラッシュ時のログ消失率を下げるため、ログ出力ごとに Flush
• ログ種別のフィルタリングはユーザ指定のラムダ式（デリゲート）
• スレッドセーフ
• シングルトン
• using staticディレクティブとの組合わせでシンプルなコード表記
• デバッガへのログメッセージ同時出力
• 実行は日本語と日本語以外（英語）に対応
• 実行環境とは異なるタイムゾーン指定が可能

Specifications and Concept

• Quality that can withstand business product development
• One type of log file per process
• Automatic subfolder allocation for multi-processes that launch the same app multiple times
• No log file capacity limit, one log file per day, files that exceed the specified storage period are deleted
• Flush for each log output to reduce the rate of log loss when the application crashes
• User-specified lambda expression (delegate) for filtering log types
• Thread-safe
• Singleton
• Simple code notation in combination with the using static directive
• Simultaneous output of log messages to the debugger
• Supports execution in Japanese and non-Japanese (English)
• Time zone different from the execution environment can be specified

使用例(Exsample)

global using

using static CFLog.Logger;
using static CFLog.Logger.LogType;

初期化(Itialization)

static void Main()
{
    ApplicationConfiguration.Initialize();
    try
    {
        // ログ機能設定(Log function settings)
        var logDef = new LoggerDef()
        {
            FILE_PREFIX = "SampleAPP",
        };
        // ログ開始(Start)
        using(CreateLogger(logDef))
        {
            Application.Run(new SampleForm());
        }
    } catch(LoggerException ex)
    {
        MessageBox.Show(ex.Message);
    }
}

ログ出力(Output)

LOG.Write(I, "情報メッセージ");
LOG.Write(E, "エラーメッセージ","追加情報\n何行でもOK");

ログテキスト(Log text)

日本語OSの場合の例。日本語以外の場合は開始、終了メッセージなどは英語になります。
Example for a Japanese OS. For non-Japanese OS, the start and end messages will be in English.

2024-04-30 16:25:15.422 <25956:01> === ログを開始します ===  [Tokyo Standard Time]
2024-04-30 16:25:17.683 <25956:01> I [Sample01Form.cs(L.12)]: 情報メッセージ
2024-04-30 16:25:17.684 <25956:01> E [Sample01Form.cs(L.13)]: エラーメッセージ
                                   追加情報
                                   何行でもOK
2024-04-30 16:25:19.379 <25956:01> === ログを終了します ===