Microsoft.Practices.EnterpriseLibrary.Logging的使用
翻译
原文地址:http://www.devx.com/dotnet/Article/36184/0/page/1
原文作者:Thiru Thangarathinam (好强大的名字)
翻译: flanker
简介
日志程序块提供了灵活的可扩展的日志机制,你可以在任何类型的.NET程序中使用它——包括WinForms、ASP.NET、控制台程序等。它提供一些可重用的日志类(也称为监控器),可以把日志信息记录在多种载体上,包括数据库、XML文件、普通文件、事件记录等。
作为开发者,你仅需选择一个监控器并且在应用程序配置文件中指明它,就可以在程序中调用基本的日志功能了。
安装完Enterprise Library 3.1后,你可以在<你的目录>/Microsoft Enterprise Library 3.1-May 2007/Bin文件夹中看到一些程序集。
使用基本的日志功能,你需要添加对Microsoft.Practices.EnterpriseLibrary.Common.dll和
Microsoft.Practices.EnterpriseLibrary.Logging.dll的引用。如果打算把信息记录在数据库中,那还需要
添加对Microsoft.Practices.EnterpriseLibrary.Data.dll的引用。图片一表示了日志程序块的依赖关系。
图片一 日志程序块的依赖关系。
建立一个简单示例
这是一个简单示例,演示了如何配置日志程序块来把日志保存到事件记录中。首先建立一个C# Windows应用程序,命名为LoggingBlockExample,如上面所说地添加程序集引用。
然后,导入如下的日志命名空间:
接下来,在应用程序配置文件(app.config)中添加配置选项,来指明日志将保存在事件记录中(见列表1)。所有配置都在<loggingConfiguration> 节点中,如下四个:
listeners —— 指明监控器,来记录日志。
formatters —— 可选元素,用来指明日志的格式。
categorySources —— 负责建立特定的日志分类和监控器的对应关系。注意,必须要给<loggingConfiguration>元素的defaultCategory属性指明一个categorySources。
specialSources —— 指明特殊的监控对象来处理特殊的日志条目。
搞定app.config后,下一步就是用日志程序块来写代码了。首先,在Windows窗体添加一个叫做btnLogMessage的按钮,对按钮添加Click事件处理如下:
{
//建立一个LogEntry对象,并设置它的属性
LogEntry entry = new LogEntry();
entry.EventId = 1;
entry.Priority = 1;
entry.Message = "This is a test message";
entry.Categories.Clear();
//注意默认的分类是General
entry.Categories.Add("General");
Logger.Write(entry);
MessageBox.Show("Log is written");
}
上面的代码使用了两个日志类:LogEntry和Logger。LogEntry表示一个日志条目,所以它提供一些属性——优先级、事件ID、日志消息等。Logger提供类方法来把日志消息写入在配置文件中指明的一个或者多个监控器里。
所以,要写一个日志消息,你应该建立一个LogEntry对象并对其属性赋值。LogEntry对象可以添加一个或者多个分类,以便让适合的监控器记录。
图片二表示了在示例程序中点击“记录日志”按钮后,日志消息被保存在事件记录中。
图片二 事件记录:通过Windows事件查看器的应用程序分类来查看纪录的日志消息。
使用Enterprise Library配置工具
虽然可以手工的修改app.config文件,但是使用Enterprise Library自带的配置工具将会更加简单。
打开Enterprise Library配置工具,建立一个新的应用程序,在Application Configuration上右击选择New → Logging Application Block。(见图片三)
图片三:Enterprise Library配置工具:这个工具使用一个向导来配置日志。
日志程序块的配置包含四个元素:Category Sources、Special Sources、Trace
Listeners、和Formatters。默认情况下,配置工具建立一个使用Text Formatter作为默认格式的Formatted
EventLog TraceListener监控器,并在Category Sources中已经添加了它。
下面讲如何通过配置工具来设置一个XML文件日志。首先要建立一个XML监控器,右击Trace Listeners节点选择New → XML Trace Listener,建立了监控器后,把右边面板的name属性改为C:/Temp/Trace.xml。
下一步是引用新的监控器,右击All Events节点选择New → Trace Listener
Reference。添加监控器引用后,把右边面板的ReferencedTraceListener属性改为XML Trace
Listener。当你完成这些时,结果应该和图片四类似。
图片四 把日志导向XML监控器:通过在All Events中引用XML监控器,你可以把日志的任何事件保存在XML文件中。
把配置工具的设置保存为app.config。现在你在C#示例项目中使用新生成的app.config,日志数据将会记录在XML日志文件中。(见图片五)
图片五 XML日志:这是一个日志记录的XML文件。注意这里有两个主要节点(System和ApplicationData)分别保存系统属性和日志。
使用数据库作为日志存储
你已经知道了如何在事件记录和XML文件中写日志了,这适合大多数的简单应用,但对更复杂的应用程序,你也许想把日志记录在一个稳定的存储中比如
SQL Server数据库。日志在数据库中也可以更方便的查询。日志程序块提供一个数据库监控器,可以实现纪录日志到数据库中。
要使用数据库日志,你首先要执行一段SQL脚本(由Enterprise
Library提供)来建立数据库。运行<你的目录>/EntLib3Src/AppBlocks/Src/Logging
/TraceListeners/Database/Scripts文件夹中的LoggingDatabase.sql文件,它会在你的SQL
Server中建立一个名为Logging的数据库。
现在,需要修改app.config文件来使用数据库监控器。你也要指明数据库连接字符串。代码中的Database App.config文件是一个完整的配置文件。
原文作者注:在使用app.config文件前,确保你已经把Database App.config文件里的<connectionStrings>元素连接字符串改为匹配你自己的数据库。
接下来,打开之前的WinForms应用程序,替换app.config文件,再次运行程序。这次点击按钮后,你就可以在Logging数据库的Log表里查看到日志条目了。
实现自定义的监控器
如果内置的监控器不能满足你的要求,日志程序块允许你来实现自定义的监控器,自定义监控器继承自CustomTraceListener类。但这些已经超出这篇文章的范围,你可以在这篇MSDN文章上获取更多信息。
你已经了解如何使用日志程序块来让你在.NET程序中建立灵活易于维护的日志系统。使用配置文件和简单代码在文件、事件记录和数据库中记录日志。当
然,配置文件是有一点儿烦人,但这总比写重复的代码甚至为了转换存储而必须要改变代码要来的好。而且,Enterprise
Library配置工具将会通过向导来简化配置工作。现在,你可以在你的应用程序中添加很棒的日志了。
关于作者
Thiru Thangarathinam
在亚利桑那州Intel公司工作。他是微软的MVP,擅长使用.NET相关技术来构架、设计和开发分布式企业级应用。他是《Professional
ASP.NET 2.0 XML》和《Professional ASP.NET 2.0
Databases》的作者,并且参与写作了一系列的.NET相关技术的书籍。他也是一个在线技术出版物的积极贡献者。Email联系。
Microsoft.Practices.EnterpriseLibrary.Logging的使用的更多相关文章
- VS - Microsoft.Practices.EnterpriseLibrary.Logging
string fileName = AppDomain.CurrentDomain.BaseDirectory + "\\log.txt";File.AppendAllText(f ...
- Microsoft.Practices.EnterpriseLibrary企业库问题
System.Configuration.ConfigurationErrorsException: Invalid TraceListenerData type in configuration ' ...
- Could not load file or assembly 'Microsoft.Practices.EnterpriseLibrary.Common, Version=5.0.414.0, ...
使用oracle数据库一个多月依赖这问题一直都得不到解决,最近任务不是很忙了,所以决定把这问题解决掉.写一篇文章做记录. 以上错误主要是net程序oracle数据库使用了Microsoft Enter ...
- Microsoft.Practices.EnterpriseLibrary
项目中使用了Microsoft.Practices.EnterpriseLibrary这个东西,根据名字猜测和微软有关系(可以翻译为:微软实践企业库). 看到了引入了两个命名空间: using Mic ...
- 缓存篇~第六回 Microsoft.Practices.EnterpriseLibrary.Caching实现基于方法签名的数据集缓存
返回目录 这一讲中主要是说EnterpriseLibrary企业级架构里的caching组件,它主要实现了项目缓存功能,它支持四种持久化方式,内存,文件,数据库和自定义,对于持久化不是今天讨论的重要, ...
- 错误:创建 cachingConfiguration 的配置节处理程序时出错: 未能加载文件或程序集“Microsoft.Practices.EnterpriseLibrary.Caching,
问题: 错误:创建 cachingConfiguration 的配置节处理程序时出错: 未能加载文件或程序集“Microsoft.Practices.EnterpriseLibrary.Caching ...
- c# 之 Microsoft.Practices.EnterpriseLibrary连接Oracle
首先下载Microsoft Enterprise Library 5.0:http://www.microsoft.com/en-us/download/details.aspx?id=15104,这 ...
- 在WebService中使用Microsoft.Practices.EnterpriseLibrary.Data配置数据库
1. 新建WebApplication1项目 1.1 新建—Web—ASP.NET Empty Web Application--WebApplication1 1.2 添加一个WebForm1 2. ...
- 第九回 Microsoft.Practices.Unity.Interception实现基于数据集的缓存(针对六,七,八讲的具体概念和配置的解说)
返回目录 概念 Microsoft.Practices.Unity.Interception是一个拦截器,它隶属于Microsoft.Practices.Unity组成之中,主要完成AOP的功能,而实 ...
随机推荐
- PostgreSQL的 initdb 源代码分析之二十一
继续分析: setup_schema(); 展开: 实质就是创建info_schema. cmd 是: "/home/pgsql/project/bin/postgres" --s ...
- DevExpress - cxGrid 使用方法
如何设置多选,并对多个选中行进行数据处理. 1.首先需要将需要获取的字段的列添加到 Grid 中,例如 grdDemoColumn1. 2.将 Grid 的 OptionsSelection 中的 C ...
- Intel大坑之中的一个:丢失的SSE2 128bit/64bit 位移指令,马航MH370??
缘由 近期在写一些字符串函数的优化,兴趣使然.但是写的过程中,想要实现 SSE2 128 bit / 64 bit 的按 bit 逻辑位移.遇到了一个大坑,且听我娓娓道来. 我并不想用什么马航370来 ...
- Hibernate征途(六)之数量和关系映射
本来如果和关系模型一样,只需要一对一.一对多.多对多映射就够了,但是前面<Hibernate征途(四)之映射 序>中说到,对象模型中关联是有方向的,所以对一对多而言,就会产生一对多还是多对 ...
- php中数组自定义排序
php中数组自定义排序方法有很多,现在只提usort();不会保留原有键名. unsort调用方法就是unsrot($arr,func); 注意: 如果func是写在当前类中的话,那么调用的方式是 u ...
- C++输入输出流的重载
C++的流插入运算符“<<”和流提取运算符“>>”是C++在类库中提供的,所有C++编译系统都在类库中提供输入流类istream和输出流类ostream.cin和cout分别是 ...
- Ruby on Rails Tutorial 第四章 Rails背后的Ruby 之 字符串
1.辅助方法 2.字符串 输入“irb”进入Ruby命令行开发环境,控制器的启动方法是在命令行中执行“rails console”. (1)字符串连接 >>"foo"+ ...
- 高级I/O之记录锁
若两个人同时编辑一个文件,其后果将如何呢?在很多UNIX系统中,该文件的最后状态取决于写该文件的最后一个进程.但是对于有些应用程序(例如数据库),进程有时需要确保它正在单独写一个文件.为了向进程提供这 ...
- C#文件操作系列(一)
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.I ...
- B. Mr. Kitayuta's Colorful Graph
B. Mr. Kitayuta's Colorful Graph time limit per test 1 second Mr. Kitayuta has just bought an undi ...