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做多表多庫存儲。