Enterprise Library - Logging Application Block 学习手册（最新版） Part 3

本文演示Enterprise Library – Logging Application Block 日志管理模块的使用，以及如何创建和使用定制的TraceListener和LogFormatter。本文由http://blog.entlib.com 开源ASP.NET博客平台小组根据EntLib HOL手册编译提供，欢迎交流。

练习三：创建和使用定制的Log Formatter
本文练习如何创建一个定制的LogFormatter，并应用到logging应用程序中。

1. 首先打开\Enterprise Library 4.1 HOL\CS\Logging\exercises\ex03\begin目录下的EnoughPI.sln项目文件，该应用程序用来计算pi值。

2. 创建定制的Log Formatter
选择Formatters\XmlFormatter.cs 文件，添加如下命名空间的引用：
using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Logging;
using Microsoft.Practices.EnterpriseLibrary.Logging.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Logging.Formatters;

添加如下的代码到XmlFormatter类中。
[align=left] [ConfigurationElementType(typeof(CustomFormatterData))][/align]
[align=left] public class XmlFormatter : LogFormatter[/align]
[align=left] {[/align]
[align=left] private NameValueCollection Attributes = null;[/align]
[align=left] [/align]
[align=left] public XmlFormatter(NameValueCollection attributes)[/align]
[align=left] {[/align]
[align=left] this.Attributes = attributes;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public override string Format(LogEntry log)[/align]
[align=left] {[/align]
[align=left] string prefix = this.Attributes["prefix"];[/align]
[align=left] string ns = this.Attributes["namespace"];[/align]
[align=left] [/align]
[align=left] using (StringWriter s = new StringWriter())[/align]
[align=left] {[/align]
[align=left] XmlTextWriter w = new XmlTextWriter(s);[/align]
[align=left] w.Formatting = Formatting.Indented;[/align]
[align=left] w.Indentation = 2;[/align]
[align=left] w.WriteStartDocument(true);[/align]
[align=left] w.WriteStartElement(prefix, "logEntry", ns);[/align]
[align=left] w.WriteAttributeString("Priority", ns,[/align]
[align=left] log.Priority.ToString(CultureInfo.InvariantCulture));[/align]
[align=left] w.WriteElementString("Timestamp", ns, log.TimeStampString);[/align]
[align=left] w.WriteElementString("Message", ns, log.Message);[/align]
[align=left] w.WriteElementString("EventId", ns,[/align]
[align=left] log.EventId.ToString(CultureInfo.InvariantCulture));[/align]
[align=left] w.WriteElementString("Severity", ns, log.Severity.ToString());[/align]
[align=left] w.WriteElementString("Title", ns, log.Title);[/align]
[align=left] w.WriteElementString("Machine", ns, log.MachineName);[/align]
[align=left] w.WriteElementString("AppDomain", ns, log.AppDomainName);[/align]
[align=left] w.WriteElementString("ProcessId", ns, log.ProcessId);[/align]
[align=left] w.WriteElementString("ProcessName", ns, log.ProcessName);[/align]
[align=left] w.WriteElementString("Win32ThreadId", ns, log.Win32ThreadId);[/align]
[align=left] w.WriteElementString("ThreadName", ns, log.ManagedThreadName);[/align]
[align=left] w.WriteEndElement();[/align]
[align=left] w.WriteEndDocument();[/align]
[align=left] [/align]
[align=left] return s.ToString();[/align]
[align=left] }[/align]
[align=left] }[/align]
}
日志记录将格式化为XML，另外需要传入2个参数，分别为prefix和namespace。
编译整个项目，确保生成定制的log formatter的DLL文件。

3. 应用定制的log formatter
使用EntLib的配置管理工具打开app.config配置文件，选择Logging Application Block | Formatters节点，添加一个新的Custom Formatter，并设置如下属性：
Name = Xml Formatter



选择Type属性，点击相应的按钮，显示Type Selector对话框，如下图所示。



选择前一步编译生成的EnoughPI.Logging.dll文件，从EnoughtPI.Logging 程序集中选择XmlFormatter类，然后点击OK按钮。

然后选择Attributes属性，点击后面的按钮，显示EditableKeyValue Collection Editor对话框，如下图所示。添加如下Key/Value值：
Key = prefix, Value = x
Key = namespace, Value = EnoughPI/2.0



你应该还记得XmlFormatter需要传入2个参数，分别为prefix和namespace，上述操作正是给这两个参数设定参数值。

然后选择 Logging Application Block | Trace Listeners | Custom TraceListener 节点，设置如下属性：Formatter = Xml Formatter



保存所有设置，然后再次运行范例程序，日志记录将再次显示在Console窗口，不过这次在窗口中显示的是XML格式。



现在，我们已经完成了创建和应用Custom Log Formatter。http://www.entlib.com专业ASP.NET电子商务平台小组，欢迎你继续访问Validation Application Block学习手册。

参考文档：
Logging Application Block Hands-On Labs for Enterprise Library