EntityClient 介绍

Posted 2020-09-17 叶祖辉

System.Data.EntityClient 命名空间是 实体框架的 .NET Framework 数据提供程序。EntityClient 提供程序使用存储特定的 ADO.NET 数据提供程序类和映射元数据与实体数据模型进行交互。EntityClient 首先将对概念性实体执行的操作转换为对物理数据源执行的操作。然后再将物理数据源返回的结果集转换为概念性实体。

EntityClient下的类有以下几个：
EntityConnection
EntityCommand
EntityConnectionStringBuilder
EntityParameter
EntityDataReader 
EntityParameterCollection
EntityProviderFactory
EntityTransaction

从类的名字上看，我们就知道它们的作用是什么了。在此，就不再一一解释了。

public static void EntityADO()
{
    // 定义连接字符串 myitEntities 是App.config里的连接字符串名
    string connStr = "name = myitEntities";
    using (EntityConnection conn = new EntityConnection(connStr))
    {
    string sql = "select value c from myitEntities.Student as c order by c.StudentID skip @start limit @end";
    conn.Open();
    EntityCommand cmd = new EntityCommand(sql, conn);
    //EntityParameter p1 = new EntityParameter("start", DbType.Int32);
    //p1.Value = 2;
    //EntityParameter p2 = new EntityParameter("end", DbType.Int32);
    //p2.Value = 3;
    //cmd.Parameters.Add(p1);
    //cmd.Parameters.Add(p2);

    //EntityParameter[] par = { 
    //                            new EntityParameter("start", DbType.Int32),
    //                            new EntityParameter("end", DbType.Int32)
    //                        };
    //par[0].Value = 2;
    //par[1].Value = 3;
    //cmd.Parameters.AddRange(par);

    cmd.Parameters.AddWithValue("start", 2);
    cmd.Parameters.AddWithValue("end", 3);

    EntityDataReader reader = cmd.ExecuteReader(CommandBehavior.SequentialAccess);
    while(reader.Read())
    {
        Console.WriteLine(reader["StudentID"]+"----"+reader.GetString(reader.GetOrdinal("StudentName")));
    }
    
    Console.WriteLine(cmd.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种写法。

> EntityCommand
它具有的方法有：ExecuteDbDataReader、 ExecuteNonQuery 、 ExecuteReader 、 ExecuteScalar等

> EntityConnectionStringBuilder
实例代码：

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)//创建连接

> EntityParameter

其中，参数是以@符号前缀的，EntityParameter实体参数类，除了可以直接构造出实例来。为实体命令对象添加参数，我们还可以直接调用Parameters.AddWithValue方法。如下代码：

     ecmd.Parameters.AddWithValue("start", 0);
     ecmd.Parameters.AddWithValue("end", 10);

我比较喜欢用上面的代码，简单、方便。

需要注意的是：CommandBehavior.SequentialAccess;这个地方。不同的枚举项，对查询会有不同影响。枚举如下：
Default 此查询可能返回多个结果集。在功能上等效于调用 ExecuteReader()。 
SingleResult 查询返回一个结果集。 
SchemaOnly 查询仅返回列信息。
KeyInfo 此查询返回列和主键信息。 
SingleRow 查询应返回一行。
SequentialAccess 提供一种方法，以便 DataReader 处理包含带有大二进制值的列的行。
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]);    
}

> EntityTransaction：
事务类。目前由于ESQL仅提供查询的命令，没有提供对Insert、Update、Delete等的支持。所以，我觉得目前这个类基本没有用，（不可能我做查询还使用事务吧！）。
从上述简单的介绍，我们可以看到，EntityClient和SqlClient下的类基本上是一致的。所以很容易掌握。其他就不多说了