Enterprise Library - Exception Handling Application Block 学习手册（最新版）Part 1
本文演示Enterprise Library – Exception Handling Application Block 异常管理模块的使用，如何将异常日志记录添加到应用程序中，以及如何使用Replace Handler隐藏敏感信息。本文由
http://blog.entlib.com 开源ASP.NET博客平台小组根据EntLib HOL手册编译提供，欢迎交流。
练习一：记录异常日志
1. 首先打开\Enterprise Library 4.1 HOL\CS\Exception Handling\exercises\ex01\begin 目录下的Puzzler.sln 项目文件。
该应用程序执行2个功能：检查单词的拼写；根据字符列表，使用字典生成单词列表。
运行应用程序，界面如下所示。在单词文本输入框，输入 ab123，然后点击 Add Word 按钮，将抛出一个未捕获异常。
下面实现如何使用Exception Handling Application Block，进行异常管理。
2. 选择PuzzlerUI 项目，添加如下dll 的引用。
Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.dll
3. 打开Puzzler.cs 代码文件，添加对ExcepitonHandling 命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.ExceptionHandling;
找到btnAddWord_Click 方法，添加try/catch 代码块，如下所示：
private void btnAddWord_Click(object sender, System.EventArgs e)
{
try
{
// TODO: Handle exceptions
PuzzlerService.Dictionary.AddWord(txtWordToCheck.Text);
errorProvider1.SetError(txtWordToCheck, "");
}
catch (Exception ex)
{
bool rethrow = ExceptionPolicy.HandleException(ex, "UI Policy");
if (rethrow)
throw;
MessageBox.Show(string.Format(
"Failed to add word {0}, please contact support.",
txtWordToCheck.Text));
}
}
4. 为 PuzzlerUI 项目添加app.config配置文件，并使用EntLib附带的配置文件编辑器打开配置文件。然后，添加 Exception Handling Application Block 的配置，如下图所示。
接下来，添加新的Exception Policy，如下图所示。
设置Exception Policy的Name属性为 UI Policy，该Policy的名称需要和前面的代码中保持一致。
bool rethrow = ExceptionPolicy.HandleException(ex, "UI Policy");
选择UI Policy 节点，添加新的Exception Type，如下图所示。
在弹出的Type Selector对话框中，选择System.Exception类型，如下图所示。
这个filter设置哪一类的Exception由异常处理代码来负责处理，将处理所有继承自System.Exception 类型的异常。另外，设置System.Exception类型的PostHandlingAction属性为None，该属性值None表示所有的异常将在异常处理代码内部处理，调用方（caller）不需要在catch代码块中重新抛出异常。
下面进一步选择Exception Handling Application Block | UI Policy | Exception 节点，并选择 New | Logging Handler 菜单项，如下图所示。这一步操作将自动添加Logging Application Block到配置文件中，你可以观察一下app.config 配置文件的变化。
选择 Exception Handling Application Block | UI Policy | Exception | Logging Handler 节点，设置如下属性：
FormatterType = TextExceptionFormatter
LogCategory = General
上述配置操作完成后，记得要保存配置文件。
5. 设置PuzzlerUI 项目添加对如下dll引用。
Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Logging.dll
因为Enterprise Library 的一个目标是保持Application Blocks之间相互低耦合，因此Exception Handling Application Block也可以不必使用Logging Application Block（例如，创建自己的异常管理Handler）。如果你使用两个application blocks，你需要引用上述的dll， Exception Handler来通过logging application block 来记录异常日志（默认安装情况下，该dll在如下目录C:\Program Files\Microsoft Enterprise Library 4.1 - October 2008\Bin）。
6. 再次运行应用程序
重复前面的步骤，在单词文本输入框，输入abc123，然后点击 Add Word 按钮，将弹出一个对话框 – Failed to add word abc123, please contact support。
检查windows的事件日志（Event Log），查看Application 日志，发现日志信息已经记录了。
为了在应用程序中给所有的代码添加try/catch，你可以考虑添加一个全局的Exception Handler。有2个events可以用来监听未捕获异常（unhandled exception）：
（1）当执行Application.Run 方法的线程发生未捕获异常时，触发Application.ThreadException事件。
（2）如果handler抛出异常，或者不在UI线程中发生异常，将触发AppDomain.UnhandledException事件。
7. 更新代码
（1）删除之前btnAddWord_Click方法中添加的代码，如下所示：
private void btnAddWord_Click(object sender, System.EventArgs e)
{
PuzzlerService.Dictionary.AddWord(txtWordToCheck.Text);
errorProvider1.SetError(txtWordToCheck, "");
}
（2）打开Startup.cs代码文件，添加命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.ExceptionHandling;
同时，在Startup类中添加如下方法来处理异常。
public static void HandleException(Exception ex, string policy)
{
Boolean rethrow = false;
try
{
rethrow = ExceptionPolicy.HandleException(ex, policy);
}
catch (Exception innerEx)
{
string errorMsg = "An unexpected exception occured while " +
"calling HandleException with policy '" + policy + "'. ";
errorMsg += Environment.NewLine + innerEx.ToString();
MessageBox.Show(errorMsg, "Application Error",
MessageBoxButtons.OK, MessageBoxIcon.Stop);
throw ex;
}
if (rethrow)
{
// WARNING: This will truncate the stack of the exception
throw ex;
}
else
{
MessageBox.Show("An unhandled exception occurred and has " +
"been logged. Please contact support.");
}
}
上述方法使用Exception Handling Application Block，如果Exception Handling Application Block自身发生问题（如遗漏配置项），也将显示有效的信息。
继续添加如下的方法作为应用程序的ThreadException事件的event handler：
static void Application_ThreadException(object sender, ThreadExceptionEventArgs e)
{
HandleException(e.Exception, "UI Policy");
}
上述方法使用前面定义过的UI Policy。在随后的练习中，将定制这一Policy，允许忽略某些异常，并关闭应用程序。
下面继续添加AppDomain的UnhandledException 事件的Event Handler：
static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
if (e.ExceptionObject is System.Exception)
{
HandleException((System.Exception)e.ExceptionObject, "Unhandled Policy");
}
}
上述代码使用了一个新的policy（Unhandled Policy），下一节将创建。Unhandled Policy 总是仅记录异常，并不重抛异常。
最后，在Main方法中，通过如下代码连接event handler和事件：
static void Main()
{
Application.ThreadException += new ThreadExceptionEventHandler(Application_ThreadException);
AppDomain.CurrentDomain.UnhandledException += new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);
Puzzler f = new Puzzler();
Application.Run(f);
}
再次运行应用程序，重复前面的测试步骤，检查弹出的消息对话框和事件日志中的异常记录，确认完成了上述所有步骤，且应用程序工作和预期一致。
参考文档：
Exception Handling Application Block Hands-On Labs for Enterprise Library