Enterprise Library使用说明文档(.net 2.0)

Enterprise Library使用说明文档（.net 2.0）1数据访问程序块首先需要配置数据库连接，与Enterprise Library 1.0不同的是，所有的配置信息默认都放在了应用程序配置文件中（App.config或者Web.config），也可以使用Configuration Sources模块建立一个File Configuration Source，指定其File节点为保存外部配置文件的路径，这样后续的各个模块的配置信息都放在这个外部配置文件中。

配置步骤：1.1打开要配置的web.config或App.config1.2配置Data Access Application Block在配置文件节点上，右键→New→Data Access Application Block，然后可是配置数据库连接，完成以后，保存配置，这样数据库的连接信息将保存在web.config中。

如果要将配置信息存储在外部文件中，请参考3步骤。

1.3将配置信息存储于外部文件同2步骤，选择Configuration Sources，默认设置为System Configuration Source（存储在web.config 或App.config）创建一个File Configuration Source节点，指定节点的File节点的值（存储外部配置文件）最后需要设置Configuration Sources下的SelectedSource节点为上面新建的File Configuration Source.这样就配置完数据访问程序块，以后的任何其他配置都将写到这个外部文件中。

1.4实例化数据库的代码private static Database defaultDB;private static object lockObj = new object();public static Database DefaultDB{get{if (defaultDB == null){lock (lockObj){if (defaultDB == null){defaultDB = DatabaseFactory.CreateDatabase("defaultDB");// 如果参数为空，则为默认的数据库}}}return defaultDB;}}///<summary>///根据实例名创建数据库实例///</summary>public static Database GetDatabase(string instanceName){//有效性验证if (String.IsNullOrEmpty(instanceName)) return null;lock (lockObj){//创建实例return DatabaseFactory.CreateDatabase(instanceName);}}2日志应用程序块2.1新建日志应用程序块2.2日志过滤（Filter）有四中过滤的方式（没有深究）。

2.3日志存储目录（Category Sources）与1.1不同的是，2.0允许建立多个存放目录，可以指定其中某一个为默认存放目录（没有深究）。

2.4Special Sources（没有深究）2.5Trace Listeners日志记录方式有8中，我们一般使用记录到数据库、发送到邮件或记录到文本文件。

2.6Formatters日志生成的格式有3种，Binary格式、自己定义格式和文本格式，一般使用文本格式（Text Formatter）。

2.7日志记录实例代码2.7.1记录到数据库首先新建一个Database Trace Listener，设置各项参数，参数依次是：新建分类的存储过程、日志记录到的数据库实例、实例对应的连接串、是林对应的数据提供者、日志格式类型、格式类型的名称、格式对应的模板、Database Trace Listene名字、TraceOutputOptions、记录日志的存储过程。

先引用：using Microsoft.Practices.EnterpriseLibrary.Logging;using Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Logging;记录日志方法：public static void WriteLog(Exception ex){// 写入默认分类Logger.Write(ex);}public static void WriteLog(Exception ex, string category){// 写入指定分类Logger.Write(ex, category);}调用：try{......}catch (Exception ex){LogMgr.WriteLog(ex);}如果要将日志信息记录到数据库，首先需要有一个记录日志的数据库，需要有3个表和3个存储过程（运行LogDB.sql即可），我目前仅将错误日志记录到Log_Log表中，其他的表没明白用来做什么。

2.7.2发送到指定的邮件地址首先新建一个Email TraceListener，设置各项参数，参数依次是格式类型、发件人邮件地址（多个使用分号分开）、Email TraceListener名称、smtp端口、stmp服务器ip地址、SubjectLineEnder、SubjectLineStarter、收件人邮件地址（多个使用分号分开）、TraceOutputOptions。

代码同2.7.1。

2.7.3记录到文本首先新建一个FlatFile TraceListener，设置各项参数，参数依次是日志存储完整路径、结尾标识、格式类型、开始标识、FlatFile TraceListener名称、TraceOutputOptions。

代码同2.7.1。

2.7.4设置关联上面的设置完成后，需要设置对应的关联，通过可视化工具很容易配置。

Logging Application Block的DefaultCategory指向General（Category可以建多个，写入日志时，可以指定分类）。

（写到数据库）（3中设置）3异常应用程序块用异常处理应用程序块的包装策略，来处理一些带有敏感信息的异常。

未经过包装策略处理过的信息，其中包含的信息将会有助于攻击者来攻破我们的系统安全。

所以应该是在服务端记录异常信息，而只发送很少的信息到客户端。

3.1创建异常策略Exception Policy只要使用异常处理块，就必须要与ExceptionPolicy类打交道，由其引出的名为HandleException()的静态方法允许客户端程序与异常处理块相交互，在此可把策略作为参数提供。

HandleException()方法使用一个类工厂来为相应的策略创建ExceptionPolicyImpl类型的对象，而ExceptionPolicyImpl对象拥有一个ExceptionPolicyEntry对象集--即在相应策略的配置文件中，每一种异常类型都对应于一个对象。

对每一种异常类型，ExceptionPolicyEntry对象都包含了一个对象集，并由其实现了IExceptionHandler接口，当执行策略时，对象集就可提供异常处理块使用的序列；且每一个实现IExceptionHandler接口的对象都与对应于每种处理方法的类型相关联。

可以建立多个异常策略（Exception Policy），用以分别包装不同的异常，假如我们按功能来划分有数据访问策略（DataAccess Policy）、界面策略（UI Policy）、未处理策略（Unhandled Policy）：3.2创建异常类型Exception Type在每一个异常策略下可以建立多个异常类型（Exception Type）。

一个异常类型可以对应一个具体的异常类型。

异常的配置属性，主要的属性是PostHandlingAction有3个：None、NotifyRethrow、ThrowNewException当选择None（推荐）时, 这将会使所有的异常都会被异常处理代码所处理。

3.3为异常创建HandlerHandler有四种方式，分别为：Custom Handler、Logging Handler、Replace Handler、Wrap Handler。

Custom Handler：这中方式的Type节点需要引入外部Assemblies，这个Assemblies可以是自己编写的，也可以是第三方的，一般不用这种方式。

Logging Handler：此异常处理方法对异常信息进行格式化处理，如通知和堆栈跟踪。

日志记录处理方法将把这些信息登记入日志块，以作日后查证。

这种方式将错误信息记录到指定的Category中。

参数依次为事件编号、存储格式类型（分TextExceptionFormatter、XmlExceptionFormatter两种）、日志目录（参考日志应用程序块）、优先级、严重程度、信息标题。

Replace Handler：此异常处理方法用一个异常取代了另一个异常。

这种方式将指定异常错误信息替换成要显示给用户的信息，比如下面的异常类型为SyntaxException，当出现这种错误时，将以“语法错误”信息替代，给用户的信息更友好，而且用户不容易找到系统潜在的问题（不过也比较麻烦，是不是需要将所有可能出现异常的都做替换信息，工作量比较大）。

Wrap Handler：这种方式感觉跟Replace Handler一样，处理方法是用一个异常包装了另一个异常。

不知道有什么区别。

参考：/article/88754缓存应用程序块4.1新建缓存应用程序块1．右击应用程序并选择New | Caching Application Block。

2．选择Caching Application Block | Cache Managers | Cache Manager节点，可以通过修改这里的一些设置来提高缓存的性能。

参数依次为：3．在Visual Studio中打开web.config或App.config配置文件，现在web.config或App.config包含了一些刚才所做的关于缓存的配置，注意到backing store是Null Storage，缓存将存储在内存中。

4.2配置持久缓存（这种方式还没实际的用过）选择Caching Application Block | Cache Managers | VideoDetail节点，选择Action | New | Isolated Storage菜单命令。