Entity Framework 学习中级篇—EF支持复杂类型的实现

http://www.cnblogs.com/xray2005/archive/2009/06/01/1493661.html

本节，将介绍如何手动构造复杂类型(ComplexType)以及复杂类型的简单操作。

通常，复杂类型是指那些由几个简单的类型组合而成的类型。比如：一张Customer表，其中有FristName和LastName字段，那么对应的Customer实体类将会有FristName和LastName这两个属性。当我们想把FirstName和LastName合成一个名为CustomerName属性时，此时，如果要在EF中实现这个目的，那么我们就需要用到复杂类型。

目前，由于EF不能显示支持复杂类型，所以我们无法在VS里的可视化设计器里面来设计我们需要的复杂类型。所以，我们需要手动修改实体模型，以便使其支持复杂类型的属性。修改的主要步骤有以下几步：

l 产生实体模型

l 修改CSDL文件

l 修改msl文件

l 重新生成模型实体类

在后续的介绍，我使用数据库使用的是NorthWind，并针对Customer表对应的实体类来增加复杂属性Address，其中复杂属性Address由Address,City,Region,Country和PostalCode这个几个组合而成。

下面，介绍具体的操作步骤：

第一步：产生实体模型

实体模型的产生我们可以直接通过在VS可视化设计器来产生（如果不会，请参考《Entity Framework 学习初级篇1--EF基本概况》）。或者使用EdmGen工具来产生（EdmGen工具位于：系统盘符:\WINDOWS\Microsoft.NET\Framework\v3.5下面）。具体步骤就不复述了。

我产生的实体模型文件是：NorthwindEnites.edmx

第二步：修改csdl文件

产生了实体模型后，我们使用记事本或其他文本编辑工具打开实体模型，（小技巧：可以把实体模型后缀.edmx改为.xml，然后把实体模型文件直接拖到VS里面进行修改，这样修改起来比较方便，待修改完毕后，将后缀改回来即可。）

接着，开始手动修改csdl文件，找到模型文件中关于csdl定义的部分，然后找到实体类型名为Customers的定义节，删除原来的Address,City,Region,Country，PostalCode属性定义，然后添加一个名为Address的属性，如下代码所示：

<Key>

</Key>

</EntityType>

接着，需要添加一个名为CommonAddress复杂类型的定义，具体如下代码：

</ComplexType>

至此，csdl部分修改完毕。

第三步，修改msl文件：

找到msl部分的定义，修改Customers部分的影射定义。具体代码如下（请注意ComplexProperty节）：

</ComplexProperty>

</MappingFragment>

</EntityTypeMapping>

</EntitySetMapping>

至此，msl部分修改完毕

第四步：重新产生实体类文件。

我们可以使用EmdGen2工具来重新实体类.cs文件。具体操作如下：

将修改好的模型文件（edmx），拷贝到使用edmgen2.exe同目录下，然后在命令行中输入：

Edmgen2 /codegen cs NorthwindEnites.edmx

执行此命令后，会在当前的文件夹下生成一个NorthwindEnites.cs代码文件，也就是实体类的代码文件。将改文件改名为：NorthwindEnites.Designer.cs（这步主要是和edmx对应起来）。

然后，将NorthwindEnites.edmx和NorthwindEnites.Designer.cs文件添加到项目中。

至此，复合类型的修改完毕。

按照同样的修改过程，我们可以给Employees也增加一个Address的复杂类型属性。

接下来，我们看看具体使用代码：

l 查询：

[Test]

public void TestAddress()

{

using (var db = new NorthwindModel.NorthwindEntities1())

{

Console.WriteLine("Get Five customer addresss :");

var cts = db.Customers.Take(5);

foreach (var c in cts)

{

Console.WriteLine("Address:{0},Country:{1},City:{2},PostalCode:{3}", c.Address.Address, c.Address.Country, c.Address.City, c.Address.PostalCode);

}

Console.WriteLine("Get Five Employess address:");

var emp = db.Customers.Take(5);

foreach (var c in emp)

{

Console.WriteLine("Address:{0},Country:{1},City:{2},PostalCode:{3}", c.Address.Address, c.Address.Country, c.Address.City, c.Address.PostalCode);

}

l 添加：

[Test]

public void AddTest()

{

using (var db = new NorthwindModel.NorthwindEntities1())

{

var customer = new NorthwindModel.Customers

{

CustomerID = "2009",

CompanyName = "Complex Company",

ContactName = "xray2005",

Address = new NorthwindModel.CommonAddress

{

Address = "SiChuan,China",

City = "ChengDou",

Country = "China",

PostalCode = "610041",

Region = "Chenghua"

}

};

db.AddToCustomers(customer);

db.SaveChanges();

var cst = db.Customers.FirstOrDefault(c => c.CustomerID == "2009");

Assert.IsNotNull(cst);

Console.WriteLine("CustomerID:{0},CompanyName:{1},ContactName:{2},City:{3},Country:{4}", cst.CustomerID, cst.CompanyName, cst.ContactName, cst.Address.City, cst.Address.Country);

}

l 条件查询：

[Test]

public void QueryTest()

{

using (var db = new NorthwindModel.NorthwindEntities1())

{

var cst = db.Customers.FirstOrDefault(c => c.Address.City == "ChengDou");

Assert.IsNotNull(cst);

Console.WriteLine("CustomerID:{0},CompanyName:{1},ContactName:{2},City:{3},Country:{4}", cst.CustomerID, cst.CompanyName, cst.ContactName, cst.Address.City, cst.Address.Country);

}

最后，补充说明：

1，在VS的可视化设计器里，不支持复杂类型，所以修改后无法再在可视化设计器里修改模型(edmx文件)。

2，复杂类型不能单独存在，它必须和某一实体相关起来。

3，复杂类型不能包含导航属性，如导航到实体或实体集。

4，复杂类型具有内部结构但没有 Key（主键）属性的数据类型

下面是示例代码和EdmGen2工具的连接。

示例代码 EdmGen2

目前，EF对存储过程的支持并不完善。存在以下问题：

l EF不支持存储过程返回多表联合查询的结果集。

l EF仅支持返回返回某个表的全部字段，以便转换成对应的实体。无法支持返回部分字段的情况。

l 虽然可以正常导入返回标量值的存储过程，但是却没有为我们自动生成相应的实体.cs代码，我们还是无法在代码中直接调用或使用标量存储过程

l EF不能直接支持存储过程中Output类型的参数。

l 其他一些问题。

下面，主要针对如何使用存储过程，以及存储返回实体、表的部分字段这个几个问题，做具体介绍。

l 导入存储过程及返回实体

在VS可视化设计器中，打开实体模型（emdx文件）。然后，鼠标右键点击“Customers”à “添加”à“函数导入”，然后选择“存储过程名称”，并输入函数导入名称，选择返回类型为实体并选择Customers。如下图所示：

之后，点击“确定”。之后，存储过程导入。在代码我们就可以使用改存储过程了。如下代码所示：

[Test]

public void GetEntityBySP()

{

using (var db = new NorthwindEntities())

{

var cst = db.GetCustomerById("ALFKI").FirstOrDefault();

Assert.IsNotNull(cst);

Console.WriteLine("CustomerId:{0},ContactName:{1}", cst.CustomerID, cst.ContactName);

}

l 联合查询结果集的问题

在此版本的EF中，是不支持存储过程的多张表联合查询的，也就是说查询的结果集中，一部分字段来自表A，另一部分字段来自表B，像这种情况，目前EF无法直接进行处理。为此，可以通过写两个或多个存储过程来实现。比如：第一个存储过程返回表A的所有字段，第二存储过程返回表B的所有字段；然后，我们在代码中来实现联合的查询。

按照前面的思路，增加一个返回所有的Orders表字段的存储过程GetOrdersByCustomerId，再增加一个返回Order Details表全部字段的存储过程GetDetailsByCustomerId，并将它们导入到实体模型中。

其中，GetOrdersByCustomerId存储过程如下：

CREATE PROCEDURE GetOrdersByCustomerId

@CustomerId varchar(5)

BEGIN

SET NOCOUNT ON;

SELECT * FROM orders WHERE orders.CustomerID=@CustomerId;

END

GetDetailsByCustomerId存储过程如下：

CREATE PROCEDURE GetDetailsByCustomerId

@CustomerId varchar(5)

BEGIN

SET NOCOUNT ON;

SELECT d.*

FROM Orders o,[Order Details] d

WHERE o.OrderId=d.OrderId AND o.CustomerId=@CustomerId;

END

之后，在我们的代码来实现联合查询。代码如下：

[Test]

public void GetOrderBySp()

{

using (var db = new NorthwindEntities())

{

var orders = db.GetOrdersByCustomerId("VINET").ToList();

var details = db.GetDetailsByCustomerId("VINET").ToList();

orders.ForEach(o => o.Order_Details.Attach(details.Where(d => d.OrderID == o.OrderID)));

foreach (var order in orders)

{

Console.WriteLine(order.OrderID);

foreach (var d in order.Order_Details)

Console.WriteLine(d.ProductID);

}

其中，需要注意的，由于是分别执行了两个存储，在内存中是以两个对立的对象存在，它们之前是没有建立联系的。为此，我们需要使用Attach方法来把他们联系起来(红色代码段)，这样我们就可以通过导航来访问对象的实体了，也就是foreach (var d in order.Order_Details)中的order.Order_Details。

l 返回部分字段的问题

默认情况，目前此版本的EF在使用存储过程返回实体的时候，必须返回所有的字段，以便是EF能够自动将返回的结果转换成对应的实体。否则会报“数据读取器与指定的XXX类型不兼容的异常，….”。

接下来，我们通过建立一个存储过程，并建立新建立一个实体来解决此问题。首先，我们在数据库中建立一个名为GetCustomerAndOrders的存储过程，其定义如下：

CREATE PROCEDURE GetCustomerAndOrders

BEGIN

SET NOCOUNT ON;

SELECT c.CustomerID,c.CompanyName,o.OrderID,o.OrderDate,d.Quantity

FROM Customers c,Orders o,[Order Details] d

WHERE c.CustomerID=o.CustomerID AND o.OrderID=d.OrderID;

END

然后，添加一个实体CustomerOders，并设置属性如下图所示：

然后，在VS可视化设计器中，打开实体模型（emdx文件），通过添加à函数导入，导入存储过程GetCustomerAndOrders，并取名为GetCustomerAndOrders，返回类型设置为实体CustomerOrders。

最后，我们就可以代码实体此实体和存储过程了。如下代码：

[Test]

public void GetOrderCountByCustomerId()

{

using (var db = new NorthwindEntities())

{

var co = db.GetCustomerAndOrders().Take(10).Skip(0);

foreach(var c in co)

Console.WriteLine(c.CustomerID);

}

l 返回标量值问题

目前，EF对存储过程返回标量值的支持并没有完全。虽然，我们可以按照前面的步骤导入函数，并设置返回标量值的类型，同时EF会在实体模型文件为我们自动生成此存储过程相关的映射配置等。但是，EF却没有为我们生成在实体模型cs文件中，自动生成相应的.cs代码，所以我们根本无法直接调用此存储过程。为解决此问题，我们需要手动添加代码到实体模型的.cs代码文件中。

首先，在数据库中建立存储存储过程GetOrderCntByCustomerId，代码如下：

CREATE PROCEDURE GetOrderCntByCustomerId

@CustomerId varchar(5)

BEGIN

SET NOCOUNT ON;

SELECT count(*) FROM Orders WHERE Orders.CustomerId=@CustomerId;

END

接着，按照正常的步骤，导入此存储过程并设置返回类型为标量类型的Int32。

然后，我们需要添加一个泛型的方法和一个执行存储过程的方法，代码如下：

public partial class NorthwindEntities

{

//泛型方法用于执行标量存储过程

private T ExecuteFunction<T>(string functionName, System.Data.EntityClient.EntityParameter[] parameters) where T : struct

{

System.Data.EntityClient.EntityCommand cmd = ((System.Data.EntityClient.EntityConnection)this.Connection).CreateCommand();

cmd.CommandType = System.Data.CommandType.StoredProcedure;

cmd.Parameters.AddRange(parameters);

cmd.CommandText = this.DefaultContainerName + "." + functionName;

try

{

if (cmd.Connection.State != System.Data.ConnectionState.Open)

cmd.Connection.Open();

var obj = cmd.ExecuteScalar();

return (T)obj;

}

catch (System.Exception)

{

throw;

}

finally

{

cmd.Connection.Close();

}

//执行数据库中GetOrderCntByCustomerId存储过程的方法

public int GetOrderCountByCustomerId(string CustomerId)

{

var param = new System.Data.EntityClient.EntityParameter("CustomerId", System.Data.DbType.String);

param.Value = CustomerId;

return ExecuteFunction<int>("GetOrderCountByCustomerId", new[] { param });

}

最后，通过以上修改，我们就可以直接使用返回标量值的存储过程，代码如下：

[Test]

public void GetOrderCountByCustomerId()

{

using (var db = new NorthwindEntities())

{

var result = db.GetOrderCountByCustomerId("VINET");

Assert.Greater(result, 0);

Console.WriteLine(result.ToString());

}

至此，我们就解决了EF存储过程返回标量的问题。

目前，EF对存储过程的支持并不完善。存在以下问题：

l EF不支持存储过程返回多表联合查询的结果集。

l EF仅支持返回返回某个表的全部字段，以便转换成对应的实体。无法支持返回部分字段的情况。

l 虽然可以正常导入返回标量值的存储过程，但是却没有为我们自动生成相应的实体.cs代码，我们还是无法在代码中直接调用或使用标量存储过程

l EF不能直接支持存储过程中Output类型的参数。

l 其他一些问题。

本节，我们将学习如何手动添加/修改存储过程，如何使EF能够支持Output类型的参数。

l 添加/修改存储过程

有时候，某个SQL语句比较复杂，但是数据库中又没有定义相应的存储过程。这个时候，我们又想使上层代码比较简单、方便的方式来完成此项任务。那么，此时，我们便可以手工在实体模型（.edmx文件）中添加自己需要的存储过程了。这样既方便上层调用又方便后期的修改。

以手动修改实体模型edmx文件，添加名为CustomerByCommandText的存储过程为例。具体步骤如下：

修改实体模型文件，找到ssdl部分，添加如下代码：

select c.* from Customers c,Orders o where c.CustomerID=o.CustomerID

</CommandText>

</Function>

然后，再找到csdl部分，添加如下代码：

接着，找到msl部分，添加如下代码：

最后，在实体模型的.cs文件里面，添加一个执行此存储过程的方法，代码如下：

public global::System.Data.Objects.ObjectResult<Customers> GetCustomerByCommandText()

{

return base.ExecuteFunction<Customers>("CustomerByCommandText");

}

至此，修改完毕。

现在，我们就可以在代码使用刚才手工定义的存储过程了。如下代码所示：

[Test]

public void GetCustomerByCmdText()

{

using (var db = new NorthwindEntities())

{

var csts = db.GetCustomerByCommandText().Take(10).Skip(0);

foreach (var c in csts)

Console.WriteLine(c.CustomerID);

}

其实，关键的地方就是CommandText这个部分的内容，它里面就是要执行的SQL语句。另外，我们可以在修改实体模型emdx文件的同时，我们可以看到所有的实体类查询的SQL语句命令都可以在edmx文件里找到，我们都可以进行相应的修改。

l Output类型参数

在实际应用当中，很多时候，我们需要使用output类型的存储过程参数，以便返回我们需要的值。但是，目前，EF不能直接支持output类型的存储过程参数。为此，我们需要对实体模型进行修改，以便使其支持output类型的输出参数。具体过程如下：

在数据库中建立一个为名的GetNameByCustomerId存储过程，代码如下：

CREATE PROCEDURE GetNameByCustomerId

@CustomerId varchar(5),

@ContactName varchar(30) output

BEGIN

SET NOCOUNT ON;

SELECT @ContactName=ContactName

FROM Customers

WHERE CustomerID=@CustomerId;

END

然后，开始修改实体模型edmx文件。

先找到ssdl定义的部分，添加如下代码：

</Function>

接着，在找到csdl定义的部分，添加如下代码：

</FunctionImport>

最后，找到msl定义的部分，添加如下代码：

至此，实体模型emdx文件修改完毕。

接下来，我们需要在实体模型的.cs文件中，增加相应的调用方法。代码如下：

public partial class NorthwindEntities1

{

//执行GetNameByCustomerId的方法

public void GetNameByCustomerId(string CustomerId, out string ContactName)

{

ContactName = string.Empty;

var Pars = new System.Data.EntityClient.EntityParameter[]

{

new System.Data.EntityClient.EntityParameter{ ParameterName="CustomerId", DbType=System.Data.DbType.String,Value=CustomerId},

new System.Data.EntityClient.EntityParameter{ParameterName="ContactName", DbType=System.Data.DbType.String, Direction=System.Data.ParameterDirection.Output}

};

this.ExecuteNonQuery("GetNameByCustomerId", Pars);

ContactName = Pars[1].Value.ToString();

}

//辅助方法，执行SQL命令

private void ExecuteNonQuery(string functionName, System.Data.EntityClient.EntityParameter[] parameters)

{

System.Data.EntityClient.EntityCommand cmd = ((System.Data.EntityClient.EntityConnection)this.Connection).CreateCommand();

cmd.CommandType = System.Data.CommandType.StoredProcedure;

cmd.Parameters.AddRange(parameters);

cmd.CommandText = this.DefaultContainerName + "." + functionName;

try

{

if (cmd.Connection.State != System.Data.ConnectionState.Open)

cmd.Connection.Open();

cmd.ExecuteNonQuery();

}

catch (System.Exception)

{

throw;

}

finally

{

cmd.Connection.Close();

}

现在，所有的修改工作都做完了。接下来，我们就可以在代码中直接调用此存储过程了。示例代码如下：

[Test]

public void OutputTest()

{

using (var db = new NorthwindModel.NorthwindEntities1())

{

string contactname = string.Empty;

db.GetNameByCustomerId("ALFKI", out contactname);

Assert.IsTrue(!string.IsNullOrEmpty(contactname));

Console.WriteLine(contactname);

}

至此，我们便可以使用Output类型的输出参数了。

在EF中，各个实体的插入、更新和删除也都通过使用存储过程来完成，以便提高点性能。这个类似于数据集。其步骤是：先定义存储过程，然后在VS的可视化设计器，设置存储过程映射即可。

下面，以为Supplier实体映射存储过程为例。

分别建立插入、更新和删除存储过程。

InsertSuppliers存储过程定义如下：

CREATE PROCEDURE [dbo].[InsertSuppliers]

-- Add the parameters for the stored procedure here

@CompanyName nvarchar(40),

@ContactName nvarchar(30),

@ContactTitle nvarchar(30),

@Address nvarchar(60),

@City nvarchar(15),

@Region nvarchar(15),

@PostalCode nvarchar(10),

@Country nvarchar(15),

@Phone nvarchar(24),

@Fax nvarchar(24),

@HomePage ntext

BEGIN

-- SET NOCOUNT ON added to prevent extra result sets from

-- interfering with SELECT statements.

SET NOCOUNT ON;

INSERT INTO Suppliers(CompanyName,ContactName,ContactTitle,Address,City,Region,PostalCode,Country,Phone,Fax,HomePage)

VALUES(@CompanyName,@ContactName,@ContactTitle,@Address,@City,@Region,@PostalCode,@Country,@Phone,@Fax,@HomePage);

SELECT SCOPE_IDENTITY() AS SupplierID;

END

DeleteSuppliers存储过程定义如下：

CREATE PROCEDURE [dbo].[DeleteSuppliers]

-- Add the parameters for the stored procedure here

@SupplierID int

BEGIN

-- SET NOCOUNT ON added to prevent extra result sets from

-- interfering with SELECT statements.

SET NOCOUNT ON;

DELETE Suppliers WHERE SupplierID=@SupplierID

END

UpdateSuppliers存储过程定义如下：

CREATE PROCEDURE [dbo].[UpdateSuppliers]

-- Add the parameters for the stored procedure here

@SupplierID int,

@CompanyName nvarchar(40),

@ContactName nvarchar(30),

@ContactTitle nvarchar(30),

@Address nvarchar(60),

@City nvarchar(15),

@Region nvarchar(15),

@PostalCode nvarchar(10),

@Country nvarchar(15),

@Phone nvarchar(24),

@Fax nvarchar(24),

@HomePage ntext

BEGIN

-- SET NOCOUNT ON added to prevent extra result sets from

-- interfering with SELECT statements.

SET NOCOUNT ON;

UPDATE Suppliers SET CompanyName=@CompanyName,ContactName=@ContactName,ContactTitle=@ContactTitle,Address=@Address,City=@City,Region=@Region,PostalCode=@PostalCode,Country=@Country,Phone=@Phone,Fax=@Fax,HomePage=@HomePage

WHERE SupplierID=@SupplierID

END

然后，在VS可视化设计器中，打开实体模式edmx文件，然后在Suppliers实体上鼠标右键à“存储过程映射”，然后在在分别设置存储过程即可。如下图所示：

至此，存储过程映射完毕。我们下面来具体的使用，代码如下：

使用存储过程Insert:

[Test]

public void SPInsert()

{

using (var db = new NorthwindEntities1())

{

var supplier = new Suppliers();

supplier.CompanyName = "cnblogs";

supplier.ContactName = "xray2005";

supplier.ContactTitle = "net";

supplier.City = "成都";

supplier.Region = "四川";

supplier.Country = "中国";

supplier.PostalCode = "600041";

supplier.Phone = "028-8001";

supplier.Fax = "028-8002";

supplier.HomePage = "http://xray2005.cnblogs.com";

db.AddToSuppliers(supplier);

db.SaveChanges();

}

使用存储过程Update:

[Test]

public void SPUpdate()

{

using (var db = new NorthwindEntities1())

{

var supplier = db.Suppliers.FirstOrDefault(s => s.SupplierID == 30);

Assert.IsNotNull(supplier);

supplier.CompanyName = "CNBLOGS";

supplier.ContactName = "xray2005";

supplier.ContactTitle = "♂风风车.net";

supplier.City = "成都";

supplier.Region = "四川";

supplier.Country = "China";

supplier.PostalCode = "600040";

supplier.Phone = "028-1008611";

supplier.Fax = "028-10086";

supplier.HomePage = "http://www.cnblogs.com/xray2005";

db.SaveChanges();

}

使用存储过程Delete:

[Test]

public void SPDelete()

{

using (var db = new NorthwindEntities1())

{

var supplier = db.Suppliers.FirstOrDefault(s => s.SupplierID == 31);

Assert.IsNotNull(supplier);

db.DeleteObject(supplier);

db.SaveChanges();

var supplier1 = db.Suppliers.FirstOrDefault(s => s.SupplierID == 31);

Assert.IsNull(supplier1);

}

至此，实体存储过程映射介绍完毕。本节，内容比较简单。