Data Access Application Block

Data Access Application Block有如下好处：

l         减少编写重复累赘代码去执行标准的任务。

l         帮助在应用程序内部和跨企业应用维护一致的数据访问实践。

l         降低改变物理数据目标的难度。

l         减轻开发人员学习不同数据库类型的不同编程模型。

l         当移植应用程序到不同数据库类型时，减少重写代码的数量。

 

Data Access Application Block依赖项：

l         Data Access Application Block依赖其他的application blocks和Enterprise Library中的代码。

l         Configuration Application Block – Data Access Application Block使用该Configuration Application Block读取配置信息。

l         Common类库功能，如instrumentation – 提供不同功能用来显示事件和系统管理的数据。

l         此外，application block使用XML文件存放配置信息，推荐采用Enteprise Library配置工具来修改这些配置信息。

 

使用Enteprise Library配置工具创建配置文件：

创建DemoDAAP应用程序，使用Configuration Console配置app.config文件。应注意Connection String的设置，在本示例中，设置Integrated Security为False，并添加User ID和Password参数及其参数值，Database属性值为Northwind。


 

选择合适的重载方法

每一个数据访问方法均有许多重载，如下的描述和指导帮助你选择合适的重载：

l         一些重载方法接受DBCommandWrapper对象，DBCommandWrapper在一个对象内同时封装了command和参数。允许你同时增加输入/输出参数和设置这些参数的类型。这些重载提供了很好的灵活性和对每一个方法的控制。

l         一些重载方法接受存储过程和存储过程参数集合，当调用仅有输入参数的存储过程时，调用这些重载比较方便。

l         一些重载方法接受System.Data.CommandType和字符串命令，当执行在线的SQL语句或没有参数的存储过程时，调用这些重载比较方便。

l         最后，上述的每一个重载都包含一个接受事务的重载方法，当在现有事务内执行方法时，允许你使用合适的重载类型。

Data Access Application Block使用向导：

1．增加对Microsoft.Practices.EnterpriseLibrary.Data.dll和Microsoft.Practices.EnterpriseLibrary.Configuration.dll的引用，并在代码在添加：

using Microsoft.Practices.EnterpriseLibrary.Data;

 

2．调用代码示例：

(1) ExecuteDataSet方法

Database db = DatabaseFactory.CreateDatabase();

DataSet dsCustomers = db.ExecuteDataSet(CommandType.Text, "Select * From Customers" );

customerGrid.DataSource = dsCustomers.Tables[0];

 

(2) ExecuteReader方法

Database db = DatabaseFactory.CreateDatabase();

 

string sqlCommand = "Select top 5 * From Customers";

DBCommandWrapper dbCommandWrapper = db.GetSqlStringCommandWrapper(sqlCommand);

 

StringBuilder readerData = new StringBuilder();

 

using (IDataReader dataReader = db.ExecuteReader(dbCommandWrapper))

{

while (dataReader.Read())

{

readerData.Append(dataReader["ContactName"]);

readerData.Append(Environment.NewLine);

}

}

 

txtResult.Text = readerData.ToString();

为了执行SQL语句，上述代码使用GetSqlStringCommandWrapper方法创建合适command wrapper对象，然后作为参数传递给ExecuteReader方法。

 

(3) ExecuteNonQuery方法

Database db = DatabaseFactory.CreateDatabase();

 

string sqlCommand = "getProductDetails";

DBCommandWrapper dbCommandWrapper = db.GetStoredProcCommandWrapper(sqlCommand);

 

// Add paramters

int productID=1;

// Input parameters can specify the input value

dbCommandWrapper.AddInParameter("@ProductID", DbType.Int32, productID);

// Output parameters specify the size of the return data

dbCommandWrapper.AddOutParameter("@ProductName", DbType.String, 40);

dbCommandWrapper.AddOutParameter("@UnitPrice", DbType.Currency, 8);

dbCommandWrapper.AddOutParameter("@QtyPerUnit", DbType.String, 20);

 

db.ExecuteNonQuery(dbCommandWrapper);

 

// Row of data is captured via output parameters

string results = string.Format(CultureInfo.CurrentCulture, "{0}, {1}, {2:C}, {3} ",

      dbCommandWrapper.GetParameterValue("@ProductID"),

      dbCommandWrapper.GetParameterValue("@ProductName"),

      dbCommandWrapper.GetParameterValue("@UnitPrice"),

      dbCommandWrapper.GetParameterValue("@QtyPerUnit"));

 

txtResult.Text = results;

为了执行存储过程，上述代码使用GetStoredProcCommandWrapper方法创建合适的command wrapper对象，然后作为参数传递给ExecuteNonQuery方法。

 

(4) ExecuteScalar方法

Database db = DatabaseFactory.CreateDatabase();

 

string sqlCommand = "GetProductName";

int productID=1;

DBCommandWrapper dbCommandWrapper = db.GetStoredProcCommandWrapper(sqlCommand, productID);

 

// Retrieve ProdcutName. ExecuteScalar returns an object, so

// we cast to the correct type (string).

string productName = (string) db.ExecuteScalar(dbCommandWrapper);

 

txtResult.Text = productName;

 

Demo程序界面如下（注意在项目属性窗口中设置Post-build Event Command Line属性值：copy "$(ProjectDir)*.config" "$(TargetDir)"）：

 

***