在 IBM DB2、IDS 和 U2 服务器中使用 LINQ 编程语言和 ADO.NET Entity Framework 开发示例应用程序

文档选项 未显示需要 JavaScript 的文档选项 英文原文

级别： 初级

Rajan Kumar, 软件开发人员, IBM
Brent Gross, 软件工程师, IBM

2009 年 5 月 07 日

IBM Data Server Provider for .NET 使应用程序开发人员能够利用 Microsoft® Entity Framework 和 LINQ。您可以使用 IBM 数据服务器（DB2®、Informix® Dynamic Server 或 U2）、Microsoft ADO.NET Entity Framework 和 LINQ 轻松开发数据访问 .NET 应用程序。本文将展示如何结合使用 Entity Framework 和一种 IBM 数据服务器，逐步引导您创建自己的应用程序。

引言

IBM Data Server Provider for .NET 支持在 IBM 数据服务器（DB2、IDS 和 U2）中使用 Microsoft Entity Framework。您可以生成实体数据模型（Entity Data Model，EDM）架构，可以使用支持的 IBM 数据服务器版本向实体应用程序编写和执行 EntitySQL 和 LINQ 语句。它支持开发人员使用概念模型查询和操作数据，而无需使用物理存储模型。

本文将展示如何使用 IBM 数据服务器数据库来利用 LINQ 和 Entity Framework。您将按照一个分步流程来开发一个简单 Windows® 应用程序，从 IBM 数据服务器数据库架构生成一个 EDM 模型，创建访问数据的 LINQ 查询，将查询结果绑定到控件，更新对象，以及将更改持久化到数据库。

IBM Data Server Provider for .NET 还具有其他许多丰富的功能，包括：

• 映射详细信息 CSDL/SSDL/MSL
• 实体 SQL 和查询生成器
• 懒惰（延迟）和预先加载
• 对象服务和变更跟踪
• 使用存储过程和 U2 子例程导入 EDM 函数
• 规范函数
• 乐观并发性
• ADO.NET 数据服务（RESTful）
• SilverLight 和 AJAX 开发
• ASP.NET 动态数据
• 使用 EDM 进行 Visual Studio Tools for Office (VSTO) 开发

重点讨论启用了 IBM Entity Framework 的 ADO.NET Provider

IBM Data Server Provider for .NET 支持以下 IBM 数据服务器：

• DB2 for Linux®, UNIX®, and Windows，9.1 版（或更高版本）
• DB2 for IBM i5/OS® V5R3
• DB2 for IBM i 5.4
• DB2 for z/OS® V7、V8 和 V9
• IBM Informix Dynamic Server，11.10 版（或更高版本）
• UniVerse 10.2（或更高版本）和 UniData® 7.1（或更高版本）

IBM Data Server Provider for .NET 支持使用 Visual Studio 2008 的以下 ADO.NET 实体数据模型（参见 参考资料 了解它们的限制）：

• 表
• 视图
• 存储过程和 U2 子例程
• LINQ to Entities
• 实体 SQL 和实体提供者（Entity SQL and Entity Provider）
• 查询生成器（Query Builder）
• 对象服务（Object Services）

回页首

了解系统需求

您需要以下软件来完成本文中的示例：

• IBM Data Server Driver for ODBC, CLI, and .NET（9.5.3 版或更高版本）
• IBM Database Add-ins for Visual Studio（9.5.3 版或更高版本）
• Visual Studio 2008 Service Pack 1
• .NET Framework 3.5 Service Pack 1

回页首

安装

IBM Data Server Provider for .NET 是 IBM Data Server Driver for ODBC, CLI, and .NET 的一个组件。可通过以下方法查看它的版本：

1. 找到 \netf20 目录（比如 c:\Program Files\IBM\IBM DATA SERVER DRIVER\bin\netf20）。
2. 右键单击 IBM.Data.DB2.dll
3. 单击 Properties。

要查看 VS2008 SP1、.NET Framework 3.5 SP1 和 IBM Database Add-ins for Visual Studio 的版本，执行以下操作：

1. 打开 Visual Studio 2008。
2. 转到 Help 菜单。
3. 单击 About Microsoft Visual Studio。

回页首

测试您的连接

在学习下面的 LINQ 和 Entity 教程之前，请检查一下您的连接。IBM Client Installation 包含一个实用工具，名为 testconn20.exe。这个工具是随安装程序一起提供的，它通常位于 c:\Program Files\IBM\SQLLIB\BIN。要执行连接测试，打开命令提示符并使用表 1 中合适的命令运行该实用工具。

回页首

了解启用了 IBM Entity Framework 的 ADO.NET Provider 架构

图 3 显示了 Entity Framework 的架构。

回页首

为本文的示例选择一个数据库

可以为本文的示例选择以下数据库。

回页首

完成示例

本节逐步引导您结合使用 LINQ 和 Entity Framework 以及 IBM 数据服务器。从较高层面上，您将：

• 创建一个 Windows 表单应用程序
• 生成一个实体数据模型（EDM）
• 查询实体、关联和与控件的数据绑定
• 插入和更新数据

创建一个 Windows 表单应用程序

要使用 Visual Studio 创建 Windows 应用程序，执行以下步骤：

1. 在 File 菜单上，单击 New Project。
   
   
2. 在 Project Types 窗格中选择 Visual Basic 或 Visual C#。
   
   
3. 在 Templates 窗格中选择 Windows Forms Application。
   
   
4. 输入 Test_EF 作为项目名称。
   
   
5. 单击 OK。

要创建表单：

1. 在 Test 项目中，选择默认表单（Form1）。
   
   
2. 在 Toolbox 中，展开 Common Controls，将 ComboBox 控件拖到表单上，并将该控件的名称更改为 comboBox。
   
   
3. 在 Toolbox 中，将 Button 控件拖到表单上，将该控件的名称更改为 closeForm，将 Text 值更改为 Close。
   
   
4. 双击 closeForm 按钮控件。这将打开表单的代码页面，并且会创建 closeForm_Click 事件处理器方法。
   
   
5. 在 closeForm_Click 事件处理器方法中，输入以下代码来关闭表单：

private void closeForm_Click(object sender, EventArgs e)
   {
       // Close the form.
           
       Close();
   }
            

生成一个实体数据模型 (EDM)

使用 Entity Data Model 向导从 IBM 数据服务器生成一个实体数据模型。

本文使用 IBM U2 UniVerse ADONET (HS.SALES) 示例数据库来进行演示。对于其他服务器，某些表和列将有所不同。但是，操作步骤是一样的。（注意 DB2 iSeries 服务器具有一个 APAR，它会影响 EDM Designer 的操作。参见 参考资料 了解更多信息。）

要添加 ADO.NET Entity Data Model 项模板，执行以下步骤：

1. 在 Solution Explorer 中选择项目，右键单击 Add 并单击 New Item。
   
   
2. 在 Templates 窗格中选择 ADO.NET Entity Data Model。
   
   
3. 输入 Customer.edmx 作为模型名称，然后单击 Add。

将显示 Entity Data Model 向导的初始页面。

要生成 EDM：

1. 在 Choose Model Contents 对话框中选择 Generate from database。
   
   
2. 单击 Next。
   
   图 7. 从数据库生成
   
   
   
3. 单击 New Connection 按钮。
   
   图 8. 新连接
   
   
   
4. 在 Choose Data Source 对话框中选择 IBM DB2, IDS and U2 Servers (IBM DB2, IDS and U2 Data Provider for .NET Framework) 数据源。
   
   
5. 单击 Continue。
   
   
6. 在 Connection Properties 对话框中，输入您的用户名、密码、服务器名称和数据库名称。例如，对于 DB2 LUW，数据库为 sample，而对于 UniVerse，数据库为 ADONET。
   
   
7. 单击 OK。
   
   图 9. 添加连接
   
   
   
8. 对于 U2（UniVerse 和 UniData），选择 Advanced 按钮，并指定 ServerType 和 Pooling。Choose Your Data Connections 对话框使用您的数据库连接设置进行更新。
   
   
9. 确保选中了 Save entity connection settings in App.Config as，将其值设置为 ADONETEntities，如图 10 所示。
   
   图 10. 保存连接字符串
   
   
   
10. 单击 Next。图 11 显示了出现的 Choose Your Database Objects 对话框。
    
    图 11. Choose Your Database Objects
    
    
    
11. 确保选择了所有表和存储过程，并且 Model 名称空间的值为 ADONETModel。
    
    
12. 单击 Finish 完成向导。

向导执行以下操作：

• 添加对 System.Data.Entity、System.Runtime.Serialization 和 System.Security 程序集的引用
  
  
• 生成定义 EDM 的 Customer.edmx 文件
  
  
• 创建一个源代码文件，其中包含根据 EDM 生成的类。可以在 Solution Explorer 中展开 .edmx 文件来查看源代码文件。
  
  
• 创建一个 App.Config 文件

要在 ADO.NET Entity Data Model Designer 中查看 EDM，打开 Solution Explorer 并双击 Customer.edmx 文件。这将在 ADO.NET Entity Data Model Designer 窗口显示 EDM 模型。如图 12 所示。

注意，对于 U2 数据服务器，有一个限制会阻止 EDM Designer 自动发现关联。参见 附录 获取解决办法。

查询实体、关联和与控件的数据绑定

要查询数据库：

1. 在表单的代码文件的开头，使用（C#）语句添加以下代码，以引用从数据库和实体名称空间创建的模型：

   C# using System.Data.Objects; using System.Data.Objects.DataClasses;

   
   
2. 在表单的 partial 类定义顶部，添加以下代码：

   C# ADONETEntities m_context ;

   
   
3. 在表单设计器中，双击表单。这将打开表单的代码页面，并创建 Form1_Load 事件处理器方法。
   
   
4. 在 Form1_Load 事件处理器方法中，复制并粘贴以下代码。或者，您可以输入代码并使用 IntelliSense 来完成代码。

   C# private void Form1_Load(object sender, EventArgs e) { m_context = new ADONETEntities(); var query = from c in m_context.CUSTOMER select c; try { this.comboBox.DisplayMember = "FNAME"; this.comboBox.DataSource = query; } catch (Exception ex) { MessageBox.Show(ex.Message); } }

   
   

要显示选定项的结果，执行以下步骤：

1. 在表单设计器中，双击 comboBox 控件。这将创建 comboBox _SelectedIndexChanged 事件处理器方法。
   
   
2. 输入以下代码。或者您可以输入代码并使用 IntelliSense 来完成代码。

   C# private void comboBox_SelectedIndexChanged(object sender, EventArgs e) { try { // lazy loading CUSTOMER lCust = (CUSTOMER)this.comboBox.SelectedItem; var query = from o in m_context.CUSTOMER_ORDERS where o.CUSTID == lCust.CUSTID select o; dataGridView.DataSource = query; dataGridView.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells); } catch (Exception ex) { MessageBox.Show(ex.Message); } }

   
   

插入和更新数据

要保存对对象的更改，执行以下步骤：

1. 在 Toolbox 中，展开 Common Controls，将 Button 控件拖到表单设计器上，将该控件的名称更改为 saveChanges，将 Text 值更改为 Update。
   
   
2. 在表单设计器中，双击 saveChanges 控件。这将创建 saveChanges_Click 事件处理器方法。
   
   
3. 输入以下代码，将对象更改保存到数据库。

   C# private void saveChanges_Click(object sender, EventArgs e) { try { // Save object changes to the database, display a message, // and refresh the form. m_context.SaveChanges(); MessageBox.Show("Changes saved to the database."); this.Refresh(); } catch (Exception ex) { MessageBox.Show(ex.Message); } }

   
   

要通过在 closeForm_Click 事件处理器方法中清理长期运行的对象上下文来关闭连接，输入以下代码。

C#

   private void closeForm_Click(object sender, EventArgs e)
   {
       // Dispose the object context.
       m_context.Dispose();
       // Close the form.
       Close();
   }
                

要编译并运行应用程序，执行以下步骤：

1. 从 Debug 菜单选择 Start Debugging 或 Start Without Debugging。这将编译并启动应用程序。
   
   
2. 当表单加载时，从 ComboBox 控件选择一个主数据。这将显示属于该主数据的细节数据。
   
   
3. 在 DataGridView 中，更新任意信息，或者添加一个新项，然后单击 Update。这会将更改保存到数据库，并显示一个消息框，说明保存的更改的数量，如图 13 所示。
   
   图 13. 运行应用程序
   
   
   

回页首

结束语

本文很好地概述了如何在 IBM 数据服务器（DB2、IDS 和 U2）中使用 LINQ 和 Entity Framework，演示了实体数据模型的概念，并展示了 Entity Framework 提供的各种查询技术。本文还展示了如何使用 LINQ 和 Entity Framework 添加、修改和删除数据

回页首

附录

对于 U2 数据服务器，有一个限制会阻止 EDM Designer 自动发现关联。您可以采用以下办法来手动添加关联。

1. 右键单击 EDM Designer。
   
   
2. 单击 Add > Association。
   
   图 14. 建立关联
   
   
   
3. 选择 CUSTOMER 和 CUSTOMER_ORDERS。
   
   图 15. 添加关联
   
   
   图 16 和 17 比较了添加新关联之前和之后的屏幕。
   
   图 16. 关联之前的模型
   
   
   
   
   图 17. 关联之后的模型
   
   
   
4. 在 U2 数据服务器上，在 XML 编辑器中打开 Customer.edmx 文件，并修改 @ASSOC_ROW。例如，您可以将 "@ASSOC_ROW" 更改为 ""@ASSOC_ROW""。

参考资料

• 访问 developerWorks 上的 IBM Information Management and Visual Studio 资源页面，查阅文章和教程，并访问其他资源来扩展您的 .NET 技能。
  
  
• 参考 wiki 上有关 IBM 数据服务器限制的文章。查看 DB2 for IBM i 部分，了解影响 EDM Designer 的操作的 DB2 iSeries 服务器 APAR 的信息。
  
  
• 开始从 “Access IBM U2 data server from your .NET applications, Part 1: Get an overview of the IBM Data Server for .NET and IBM Database Add-ins”（developerWorks，2007 年 11 月）浏览信息。
  
  
• 从 “使用 IBM Database Add-Ins for Visual Studio 创建 IBM Data Web Services”（developerWorks，2009 年 2 月）找到更多信息。
  
  
• 查阅教程 “ASP.NET development with IBM U2 Data Server”（developerWorks，2008 年 2 月），使用 UniVerse、UniData、IBM Data Server Provider for .NET、IBM Database Add-ins 和 ASP.NET 2.0 构建新一代应用程序。
  
  
• 了解关于 U2 产品系列 的更多信息。
  
  
• 根据此 概述 选择合适的 IBM 数据服务器客户端或驱动器。
  
  
• 在 developerWorks Information Management 专区 了解关于信息管理的更多信息。查找技术文档、操作文章、培训、下载、产品信息等信息。
  
  
• 随时关注 developerWorks 技术活动和网络广播。
  
  

• 下载 IBM Data Server Driver for ODBC, CLI, and .NET。
  
  
• 下载 IBM Database Add-ins for Visual Studio。
  
  
• 使用 IBM 试用软件 构建您的下一个开发项目，这些软件可直接从 developerWorks 下载获得。
  
  

• 参与有关使用 DB2、IDS 和 U2 进行 .NET 开发的 讨论论坛。
  
  
• 阅读 ADO.NET 团队博客。
  
  
• 访问 developerWorks 博客 并参与 developerWorks 社区。

作者简介

		Rajan 是位于科罗拉多州丹佛的 IBM U2 Data Management Software Group 的一名开发人员。它主要研究 UniVerse 和 UniData 的 .NET、Windows 和 Java 数据访问工具。他目前正在参与 IBM data server provider for .NET 和 IBM Database Add-ins for Visual Studio 项目。

		Brent Gross 是多伦多实验室的 IBM Information Management Development 的一名资深软件工程师。他拥有超过 20 年与 IBM 合作的丰富经验，他从 1995 年就开始进行 DB2 开发。他的研究领域包括存储过程支持和客户端界面的架构和开发。Brent 经常出席许多 DB2 和用户组会议，他目前是 .NET and OLE DB APIs for DB2 and DB2 Connect 的架构师。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 建议？

回页首