为了查看系统运行情况和方便程序调试,采用开源日志管理组件log4net,在ExpressPlugin中增加了日志记录功能。
每次系统运行时,自动记录下启动时的插件加载情况和系统退出信息,其中插件加载情况包括插件dll文件是否找到,某个菜单初始化失败,以及菜单的图标缺失等错误信息,便于检查系统配置和程序bug。
日志输出配置:
日志的输出格式和输出位置可通过应用程序的配置文件来指定,该文件通常位于系统启动目录下,名称为abc.exe.config,其中abc为应用程序名。常用配置的格式如下:
代码
<configuration>
<configSections>
<section name="log4net" type="System.Configuration.IgnoreSectionHandler" />
</configSections>
<runtime>
</runtime>
<log4net>
<!-- 控制台日志 -->
<appender name="TraceAppender" type="log4net.Appender.TraceAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level- %message%newline" />
</layout>
</appender>
<!-- 文本日志 -->
<appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
<param name="File" value="applog.txt" />
<param name="AppendToFile" value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level- %message%newline" />
</layout>
</appender>
<root>
<level value="DEBUG" />
<appender-ref ref="TraceAppender" />
<appender-ref ref="LogFileAppender" />
</root>
</log4net>
</configuration>
以上的配置信息指明日志的输出位置有两个:控制台和文本文件(applog.txt)。在调试程序时,可在输出控制台看到日志信息,同时在日志文件中会有相同的信息(追加到日志文件末尾)。
日志信息示例:
2010-05-27 11:21:30,078 INFO - 系统启动...
2010-05-27 11:21:30,093 INFO - 读取资源...
2010-05-27 11:21:30,562 INFO - 开始加载运行库: ExpressPlugin
2010-05-27 11:21:30,562 INFO - 开始加载运行库: ExpressPluginDemo
2010-05-27 11:21:31,156 ERROR- 未能找到菜单项[保存]的图标:saveicon
2010-05-27 11:21:31,171 INFO - 系统初始化完成.
2010-05-27 11:21:34,000 INFO - 系统退出.
2010-05-27 11:21:30,093 INFO - 读取资源...
2010-05-27 11:21:30,562 INFO - 开始加载运行库: ExpressPlugin
2010-05-27 11:21:30,562 INFO - 开始加载运行库: ExpressPluginDemo
2010-05-27 11:21:31,156 ERROR- 未能找到菜单项[保存]的图标:saveicon
2010-05-27 11:21:31,171 INFO - 系统初始化完成.
2010-05-27 11:21:34,000 INFO - 系统退出.
日志接口:
如果需要在系统运行过程中记录下一些错误信息或者运行状态,可在代码中调用框架提供的日志接口,使这些信息和日志一起保存和输出。框架中提供了一个静态类LoggingService用来记录日志,其中包含若干日志记录接口,分别记录不同等级的信息(共有Debug,Info,Warn,Error,Fatal五个等级)。
示例代码:
LoggingService.Info("加载系统资源...");
LoggingService.Error("系统发生错误,无法打开指定文件。");
LoggingService.Fatal("致命错误,系统即将关闭。");
更新下载:
ExpressPlugin_SetupV2.0.rar