1、引言
在上位機開發中,日志記錄是必不可少的,我們可以通過日志記錄做日志分析及錯誤追蹤。初學者會采用txt文本寫入來實現日志保存,但是文本寫入不是線程安全,當存在多個線程同時寫入日志時,就會出現一些問題。Log4net庫是.Net下一個非常優秀的開源日志記錄組件,是一個幫助開發者將日志信息輸出到各種目標(控制台、文件、數據庫等)的工具。本節主要采用開源組件Log4Net來實現錯誤ERROR信息文本存儲,並結合SQLite數據庫,將日志INFO信息存儲到數據庫中,便於后續的查詢。
2、開發准備
- 首先新建一個Windows窗體應用,取名為thinger.cn.Log4NetSQLitePro,UI界面設計如下所示:
- 通過Nuget添加Log4Net開源組件,如下所示:
- 通過Nuget添加SQLite組件,如下所示:
3、文本存儲
一般情況下,我們可以將一些錯誤及異常信息存儲在文本中,便於隨時打開文件進行查詢,文本存儲將自動以天為單位,每天對應一個文件,步驟如下:
-
添加一個應用程序配置文件
項目右擊添加新建項,項目類型選擇應用程序配置文件,名稱為log4net.config,如下所示:
-
配置文件編寫
日志配置文件增加相關節點,如下所示:
配置文件規定了日志信息的相關屬性、存儲方式、日志內容格式等,配置信息如下所示:
其中,較為重要的是日志信息的格式,對應上面文件中的ConversionPattern,值為"[%d]%n%m%n%n",每個占位符有對應的含義,如下所示:
- 配置文件屬性中的復制到輸出目錄,設置為始終復制或如果較新則復制,如下圖所示:
-
項目的AssemblyInfo.cs類中添加一行代碼,如下所示:
-
添加一個LogHelper類,編寫2個Error的方法,如下所示:
-
在ini文本存儲按鈕事件下,調用錯誤日志寫入,如下所示:
執行完成后,在項目目錄,Log\Error目錄下,產生一條當天日志命名的文件,打開如下所示
4、SQLite存儲
日志信息存儲到數據庫的好處在於便於用戶通過界面進行查詢,這里采用開源免費數據庫SQLite,其他關系型數據庫,如SQLServer、mysql,原理都是一樣的,具體步驟如下所示:
-
創建數據庫及數據表
通過SQLiteStudio軟件創建一個數據庫,取名為Log4NetSQLite,執行以下腳本創建一個Log數據表:
-
將數據庫文件復制到項目根目錄下的DataBase文件夾中
-
修改log4net.config文件,增加數據庫存儲相關配置,如下所示:
bufferSize:日志緩存寫入條數 設置為0時只要有一條就立刻寫到數據庫
connectionString:SQLite指向的是數據庫文件的絕對路徑
-
LogHelper類中增加一個Info方法,如下所示:
-
在SQLite存儲按鈕事件下,調用Info日志寫入,如下所示:
-
執行完成后,打開數據庫,查看是否有相關記錄:
5、實際應用
通過上面一系列的描述,相信大家對Log4Net的應用有了一些了解,Log4Net構建的日志系統是很多項目必備的一個功能,對項目開發、調試及后續維護都有着至關重要的作用。實際使用時,我們還可以將Log4Ne作為一個簡單的數據存儲工具,甚至可以使用Log4Net做多表多庫存儲。