练习3:创建并使用自定义LogFormatter<?XML:NAMESPACE PREFIX = O />

在本练习中将创建一个自定义的LogFormatter,并在应用程序中使用它。

 

第一步

打开EnoughPI.sln项目,默认的安装路径应该为C:\Program Files\Microsoft Enterprise Library January 2006\labs\cs\Logging\exercises\ex03\begin,并编译。

 

第二步 创建自定义LogFormatter

1 .在解决方案管理器中选择Formatters\XmlFormatter.cs文件,选择View | Code菜单命令,添加如下命名空间。
None.gif using  Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
None.gif
None.gif
using  Microsoft.Practices.EnterpriseLibrary.Logging;
None.gif
None.gif
using  Microsoft.Practices.EnterpriseLibrary.Logging.Configuration;
None.gif
None.gif
using  Microsoft.Practices.EnterpriseLibrary.Logging.Formatters;
2 .添加如下代码到XmlFormatter类中。
None.gif [ConfigurationElementType( typeof (CustomFormatterData))]
None.gif
None.gif
public   class  XmlFormatter : LogFormatter
None.gif
ExpandedBlockStart.gifContractedBlock.gif
dot.gif {
InBlock.gif
InBlock.gif    
private NameValueCollection Attributes = null;
InBlock.gif
InBlock.gif 
InBlock.gif
InBlock.gif    
public XmlFormatter(NameValueCollection attributes)
InBlock.gif
ExpandedSubBlockStart.gifContractedSubBlock.gif    
dot.gif{
InBlock.gif
InBlock.gif        
this.Attributes = attributes;
InBlock.gif
ExpandedSubBlockEnd.gif    }

InBlock.gif
InBlock.gif 
InBlock.gif
InBlock.gif    
public override string Format(LogEntry log)
InBlock.gif
ExpandedSubBlockStart.gifContractedSubBlock.gif    
dot.gif{
InBlock.gif
InBlock.gif        
string prefix = this.Attributes["prefix"];
InBlock.gif
InBlock.gif        
string ns = this.Attributes["namespace"];
InBlock.gif
InBlock.gif 
InBlock.gif
InBlock.gif        
using (StringWriter s = new StringWriter())
InBlock.gif
ExpandedSubBlockStart.gifContractedSubBlock.gif        
dot.gif{
InBlock.gif
InBlock.gif            XmlTextWriter w 
= new XmlTextWriter(s);
InBlock.gif
InBlock.gif            w.Formatting 
= Formatting.Indented;
InBlock.gif
InBlock.gif            w.Indentation 
= 2;
InBlock.gif
InBlock.gif 
InBlock.gif
InBlock.gif            w.WriteStartDocument(
true);
InBlock.gif
InBlock.gif            w.WriteStartElement(prefix, 
"logEntry", ns);
InBlock.gif
InBlock.gif            w.WriteAttributeString(
"Priority", ns,
InBlock.gif
InBlock.gif                log.Priority.ToString(CultureInfo.InvariantCulture));
InBlock.gif
InBlock.gif            w.WriteElementString(
"Timestamp", ns, log.TimeStampString);
InBlock.gif
InBlock.gif            w.WriteElementString(
"Message", ns, log.Message);
InBlock.gif
InBlock.gif            w.WriteElementString(
"EventId", ns,
InBlock.gif
InBlock.gif                log.EventId.ToString(CultureInfo.InvariantCulture));
InBlock.gif
InBlock.gif            w.WriteElementString(
"Severity", ns, log.Severity.ToString());
InBlock.gif
InBlock.gif            w.WriteElementString(
"Title", ns, log.Title);
InBlock.gif
InBlock.gif            w.WriteElementString(
"Machine", ns, log.MachineName);
InBlock.gif
InBlock.gif            w.WriteElementString(
"AppDomain", ns, log.AppDomainName);
InBlock.gif
InBlock.gif            w.WriteElementString(
"ProcessId", ns, log.ProcessId);
InBlock.gif
InBlock.gif            w.WriteElementString(
"ProcessName", ns, log.ProcessName);
InBlock.gif
InBlock.gif            w.WriteElementString(
"Win32ThreadId", ns, log.Win32ThreadId);
InBlock.gif
InBlock.gif            w.WriteElementString(
"ThreadName", ns, log.ManagedThreadName);
InBlock.gif
InBlock.gif            w.WriteEndElement();
InBlock.gif
InBlock.gif            w.WriteEndDocument();
InBlock.gif
InBlock.gif 
InBlock.gif
InBlock.gif            
return s.ToString();
InBlock.gif
ExpandedSubBlockEnd.gif        }

InBlock.gif
ExpandedSubBlockEnd.gif    }

InBlock.gif
ExpandedBlockEnd.gif}
日志项将被格式化为 XML格式,并且它期望接收两个参数 prefixnamespace

3 .选择Build | Build Solution编译整个解决方案。

 

第三步 使用自定义LogFormatter

1 .在解决方案管理器中选择项目EnoughPI的配置文件App.config文件,选择View | Open With…菜单命令,选择Enterprise Library Configuration并单击OK按钮。

2 .选中Logging Application Block | Formatters节点,选择Action | New | Custom Formatter菜单命令,并设置属性Name的为Xml Formatter

<?XML:NAMESPACE PREFIX = V />

3 .选择Type属性,单击ellipses显示Type Selector对话框。

4 .从程序集EnoughPI.Logging中选择XmlFormatter类并单击OK按钮。

Type Selector列表中的类,来自于与Enterprise Library Configuration配置工具在同一目录下的程序集,它们继承于基类LogFormatter,并且有一个值为CustomTraceListenerData的特性ConfigurationElementType

5 .选择Attributes属性并单击ellipses显示EditableKeyValue Collection Editor

6 .添加如下键值对

Key = prefix, Value = x

Key = namespace, Value = EnoughPI/2.0

并单击OK按钮。

还记得在类XmlFormatter中期望接受的两个参数prefixnamespace

7 .选择Logging Application Block | Trace Listeners | Custom TraceListener节点,并设置属性FormatterXml Formatter

8 .选择File | Save All保存配置,并关闭Enterprise Library Configuration工具。

9 .选择Debug | Start Without Debugging菜单命令并运行应用程序,EnoughPI程序用来计算∏的精度。在NumericUpDown控件中输入你希望的精度并点击Calculate按钮。可以看到日志项显示在一个控制台窗口中。

完成后的解决方案代码如C:\Program Files\Microsoft Enterprise Library January 2006\labs\cs\Logging\exercises\ex03\end所示。

 

注意根据Hands On Lab给出的时间建议,做完以上三个练习的时间应该为30分钟。

 

更多Enterprise Library的文章请参考《Enterprise Library系列文章