System.Data.EntityClient 命名空间是 实体框架的 .NET Framework 数据提供程序。EntityClient 提供程序使用存储特定的 ADO.NET 数据提供程序类和映射元数据与实体数据模型进行交互。EntityClient 首先将对概念性实体执行的操作转换为对物理数据源执行的操作。然后再将物理数据源返回的结果集转换为概念性实体。
EntityClient下的类有以下几个：
l EntityConnection
l EntityCommand
l EntityConnectionStringBuilder
l EntityParameter
l EntityDataReader
l EntityParameterCollection
l EntityProviderFactory
l EntityTransaction
从类的名字上看，我们就知道它们的作用是什么了。在此，就不再一一解释了。直接通过实例代码来学习它们。
l EntityConnection:
实例代码1：
string con = "name = NorthwindEntities";
using (EntityConnection econn = new EntityConnection(con))
{
string esql = "Select VALUE c from NorthwindEntities.Customers as c where c.CustomerID='ALFKI'";
econn.Open();
EntityCommand ecmd = new EntityCommand(esql, econn);
EntityDataReader ereader = ecmd.ExecuteReader(CommandBehavior.SequentialAccess);
if (ereader.Read())
{
Console.WriteLine(ereader["CustomerID"]);
}
Console.WriteLine(ecmd.ToTraceString());
}
上述代码中，需要注意的是EntityConnection的构造方法。其中，连接字符串写法有多很，如下：
写法1：
string con ="name = NorthwindEntities" ;其中的”NorthwindEntities”是配置文件中的连接字符串名称
写法2:
string con = System.Configuration.ConfigurationManager.ConnectionStrings["NorthwindEntities"].ConnectionString; 其中的”NorthwindEntities”是配置文件中的连接字符串名称
写法3:
string con = @" metadata=res://*/NorthWind.csdl|res://*/NorthWind.ssdl|res://*/NorthWind.msl;provider=System.Data.SqlClient;provider connection string='Data Source=.\SQLEXPRESS;Initial Catalog=Northwind;Integrated Security=True;MultipleActiveResultSets=True'";其中的这些字符串是配置文件中的连接字符串的值
写法4:
NorthwindEntities edm = new NorthwindEntities();
string con = edm.Connection.ConnectionString;
上述写法中,基于写法简单、方便我比较推荐使用第1种或者第2种写法。
l EntityCommand
它具有的方法有：ExecuteDbDataReader、 ExecuteNonQuery 、 ExecuteReader 、 ExecuteScalar等。
实例代码2：
string con = "name = NorthwindEntities";
using (EntityConnection econn = new EntityConnection(con))
{
string esql = "Select VALUE c from NorthwindEntities.Customers as c where c.CustomerID='ALFKI'";
econn.Open();
EntityCommand ecmd = econn.CreateCommand();
ecmd.CommandText = esql;
EntityDataReader ereader = ecmd.ExecuteReader(CommandBehavior.SequentialAccess);
if (ereader.Read())
{
Console.WriteLine(ereader["CustomerID"]);
}
Console.WriteLine(ecmd.ToTraceString());
}
代码中，EntityCommand创建方式和实例代码1中的稍有不同，相信大家都明白，就不多说了。
l EntityConnectionStringBuilder
实例代码3：
EntityConnectionStringBuilder esb = new EntityConnectionStringBuilder();
esb.Provider = "System.Data.SqlClient";
esb.Metadata = @"res://*/NorthWind.csdl|res://*/NorthWind.ssdl|res://*/NorthWind.msl";
esb.ProviderConnectionString = @"Data Source=.\SQLEXPRESS;Initial Catalog=Northwind;Integrated Security=True;MultipleActiveResultSets=True";
EntityConnection econn = new EntityConnection(esb.ConnectionString)//创建连接
l EntityParameter
代码实例4：
string con = "name = NorthwindEntities";
using (EntityConnection econn = new EntityConnection(con))
{
string esql = "Select value c from NorthwindEntities.Customers as c order by c.CustomerID skip @start limit @end";
econn.Open();
EntityCommand ecmd = new EntityCommand(esql, econn);
EntityParameter p1 = new EntityParameter("start", DbType.Int32);
p1.Value = 0;
EntityParameter p2 = new EntityParameter("end", DbType.Int32);
p2.Value = 10;
ecmd.Parameters.Add(p1);
ecmd.Parameters.Add(p2);
EntityDataReader ereader = ecmd.ExecuteReader(CommandBehavior.SequentialAccess);
while (ereader.Read())
{
Console.WriteLine(ereader["CustomerID"]);
}
Console.WriteLine(ecmd.ToTraceString());
}
其中，参数是以@符号前缀的，EntityParameter实体参数类，除了可以直接构造出实例来。为实体命令对象添加参数，我们还可以直接调用Parameters.AddWithValue方法。如下代码：
ecmd.Parameters.AddWithValue("start", 0);
ecmd.Parameters.AddWithValue("end", 10);
我比较喜欢用上面的代码，简单、方便。
l EntityDataReader
string con = "name = NorthwindEntities";
using (EntityConnection econn = new EntityConnection(con))
{
string esql = "Select value c from NorthwindEntities.Customers as c order by c.CustomerID limit 10 ";
econn.Open();
EntityCommand ecmd = new EntityCommand(esql, econn);
EntityDataReader ereader = ecmd.ExecuteReader(CommandBehavior.SequentialAccess);
while (ereader.Read())
{
Console.WriteLine("{0},{1},{2},{3},{4}", ereader[0], ereader[1], ereader[2], ereader[3], ereader[4]);
}
Console.WriteLine(ecmd.ToTraceString());
}
需要注意的是：CommandBehavior.SequentialAccess;这个地方。不同的枚举项，对查询会有不同影响。枚举如下：
l Default 此查询可能返回多个结果集。在功能上等效于调用 ExecuteReader()。
l SingleResult 查询返回一个结果集。
l SchemaOnly 查询仅返回列信息。
l KeyInfo 此查询返回列和主键信息。
l SingleRow 查询应返回一行。
l SequentialAccess 提供一种方法，以便 DataReader 处理包含带有大二进制值的列的行。
l CloseConnection 在执行该命令时，如果关闭关联的 DataReader 对象，则关联的 Connection 对象也将关闭。
需要说明的是，如果使用SequentialAccess则需按顺序访问列，否则将抛异常。如下代码，将会抛异常：
while (ereader.Read())
{
//异常信息：从列序列号“ 1”开始读取的尝试无效。通过CommandBehavior.SequentialAccess，只能从列序列号“5”或更大值处开始读取
Console.WriteLine("{0},{1},{2},{3},{4}", ereader[4], ereader[1], ereader[2], ereader[3], ereader[0]);
}
l EntityTransaction：
事务类。目前由于ESQL仅提供查询的命令，没有提供对Insert、Update、Delete等的支持。所以，我觉得目前这个类基本没有用，（不可能我做查询还使用事务吧！）。
从上述简单的介绍，我们可以看到，EntityClient和SqlClient下的类基本上是一致的。所以很容易掌握。其他就不多说了。
相关文章
