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，如上面所说地添加程序集引用。
然后，导入如下的日志命名空间：
using Microsoft.Practices.EnterpriseLibrary.Logging;接下来，在应用程序配置文件（app.config）中添加配置选项，来指明日志将保存在事件记录中（见列表1）。所有配置都在<loggingConfiguration> 节点中，如下四个：
listeners —— 指明监控器，来记录日志。
formatters —— 可选元素，用来指明日志的格式。
categorySources —— 负责建立特定的日志分类和监控器的对应关系。注意，必须要给<loggingConfiguration>元素的defaultCategory属性指明一个categorySources。
specialSources —— 指明特殊的监控对象来处理特殊的日志条目。
搞定app.config后，下一步就是用日志程序块来写代码了。首先，在Windows窗体添加一个叫做btnLogMessage的按钮，对按钮添加Click事件处理如下：
<?xml version="1.0" encoding="utf-8" ?> <loggingConfiguration name="" tracingEnabled="true" defaultCategory="General"> <listeners> <add name="MSMQTraceListener" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.MsmqTraceListener,Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.MsmqTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" recoverable="true" useDeadLetterQueue="true" timeToReachQueue="24.00:00:00" timeToBeReceived="24.00:00:00" queuePath=".\private$\opasloggingqueue" formatter="Binary Log Message Formatter" /> <add name="ServiceEvent" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" formatter="Text Formatter" rollFileExistsBehavior="Increment" fileName="Logging/ServiceEvent.log" header="" rollInterval="Day" rollSizeKB="1000" /> <add name="ExceptionLog" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" formatter="Error Text Formatter" rollFileExistsBehavior="Increment" fileName="Logging/Error.log" header="" rollInterval="Day" rollSizeKB="1000" /> </listeners> <formatters> <add type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.BinaryLogFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" name="Binary Log Message Formatter" /> <add type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" template="Timestamp: {timestamp}{newline}
Message: {message}{newline}
Category: {category}{newline}
Priority: {priority}{newline}
EventId: {eventid}{newline}
Severity: {severity}{newline}
Title:{title}{newline}
Machine: {localMachine}{newline}
App Domain: {localAppDomain}{newline}
ProcessId: {localProcessId}{newline}
Process Name: {localProcessName}{newline}
Thread Name: {threadName}{newline}
Win32 ThreadId:{win32ThreadId}{newline}
Extended Properties: {dictionary({key} - {value}{newline})}" name="Error Text Formatter" /> <add type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" template="Timestamp: {timestamp}{newline}
Message: {message}" name="Text Formatter" /> <add type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=a20767533a162583" template="Timestamp: {timestamp}{newline}
{message}" name="XML Formatter" /> </formatters> <categorySources> <add switchValue="All" name="General"> <listeners> <add name="MSMQTraceListener" /> </listeners> </add> <add switchValue="All" name="Exception"> <listeners> <add name="MSMQTraceListener" /> </listeners> </add> </categorySources> <specialSources> <allEvents switchValue="All" name="All Events" /> <notProcessed switchValue="All" name="Unprocessed Category" /> <errors switchValue="All" name="Logging Errors & Warnings"> <listeners> <add name="ExceptionLog" /> </listeners> </errors> </specialSources> </loggingConfiguration>
private void btnLogMessage_Click(object sender, EventArgs e)
{
//建立一个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联系。
