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下的类基本上是一致的。所以很容易掌握。其他就不多说了。