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下的类基本上是一致的。所以很容易掌握。其他就不多说了。(文/♂风车车.Net )