对象关系设计器(O/R 设计器)提供了一个可视化设计图面,用于创建和编辑基于数据库中对象的 LINQ to SQL 类(实体类)。通过使用 LINQ to SQL [LINQ to SQL],可以使用 LINQ 技术访问 SQL 数据库。有关更多信息,请参见LINQ(语言集成查询)

默认情况下,由 LINQ to SQL 运行时提供用于执行更新的逻辑。该运行时基于表的架构(列定义和主键信息)创建默认的 Insert、Update 和 Delete 语句。当不希望使用默认行为时,可以配置更新行为并指定特定的存储过程,来执行处理数据库中数据所必需的插入、更新和删除。在不生成默认行为时(例如,实体类映射到视图时),也可以这样做。另外,在数据库要求通过存储过程访问表时,您可以重写默认的更新行为。有关更多信息,请参见 使用存储过程自定义操作

备注

本演练要求可以使用 Northwind 数据库的“InsertCustomer”“UpdateCustomer”“DeleteCustomer”存储过程。有关如何创建这些存储过程的详细信息,请参见演练:为 Northwind Customers 表创建更新存储过程

本演练提供了一些步骤,您必须执行这些步骤来重写默认的 LINQ to SQL 运行时行为,以便使用存储过程将数据保存回数据库。

在本演练中,您将学习如何执行以下任务:

  • 创建一个新的 Windows 窗体应用程序,并将一个 LINQ to SQL 文件添加到该应用程序。

  • 创建一个映射到 Northwind Customers 表的实体类。

  • 创建一个引用 LINQ to SQL Customer 类的对象数据源。

  • 创建一个包含绑定到 Customer 类的 DataGridView 的 Windows 窗体。

  • 实现该窗体的保存功能。

  • 通过将存储过程添加到 O/R 设计器来创建 DataContext 方法。

  • 配置 Customer 类以使用存储过程执行插入、更新和删除。

先决条件

若要完成此演练,需要以下组件:

创建一个应用程序并添加 LINQ to SQL 类

因为您将要使用 LINQ to SQL 类并在 Windows 窗体中显示数据,所以需要创建一个新的 Windows 窗体应用程序并添加一个 LINQ to SQL 类文件。

新建一个包含 LINQ to SQL 类的 Windows 应用程序项目

  1. 从**“文件”**菜单创建一个新的项目。

  2. 将该项目命名为“UpdatingwithSProcsWalkthrough”。

    备注

    Visual Basic 和 C# 项目都支持 O/R 设计器。因此,请使用这两种语言之一创建新项目。

  3. 单击**“Windows 窗体应用程序”模板,然后单击“确定”**。有关更多信息,请参见 开发客户端应用程序

    将创建 UpdatingwithSProcsWalkthrough 项目并将其添加到**“解决方案资源管理器”**中。

  4. 在**“项目”菜单上单击“添加新项”**。

  5. 单击**“LINQ to SQL 类”模板,然后在“名称”**框中键入 Northwind.dbml。

  6. 单击**“添加”**。

    这会将一个空的 LINQ to SQL 类文件 (Northwind.dbml) 添加到该项目中,并且会打开 O/R 设计器。

创建 Customer 实体类和对象数据源

通过将数据库表从**“服务器资源管理器”/“数据库资源管理器”**拖动到 O/R 设计器上,创建映射到这些表的 LINQ to SQL 类。结果将生成映射到数据库中的表的 LINQ to SQL 实体类。在创建实体类后,可以将这些类像具有公共属性的其他类一样用作对象数据源。

创建 Customer 实体类并使用该类配置数据源

  1. 在**“服务器资源管理器”/“数据库资源管理器”**中,查找 Northwind 示例数据库的 SQL Server 版本中的 Customer 表。有关更多信息,请参见如何:创建到 Northwind 数据库的数据连接

  2. 将**“Customers”节点从“服务器资源管理器”/“数据库资源管理器”**拖动到 O/R 设计器图面上。

    将创建一个名为**“Customer”的实体类。该类具有与 Customers 表中的列相对应的属性。由于该实体类表示 Customers 表中的单个客户,因此将该类命名为“Customer”(而不是“Customers”**)。

    备注

    这种重命名行为称为“复数化”。可以在“选项”对话框 (Visual Studio) 中打开或关闭此行为。有关更多信息,请参见如何:打开和关闭复数形式(O/R 设计器)

  3. 在**“生成”菜单上单击“生成 UpdatingwithSProcsWalkthrough”**以生成该项目。

  4. 在**“数据”菜单上单击“显示数据源”**。

  5. 在**“数据源”窗口中,单击“添加新数据源”**。

  6. 单击**“选择数据源类型”页上的“对象”,然后单击“下一步”**。

  7. 展开**“UpdatingwithSProcsWalkthrough”节点,然后找到并选择“Customer”**类。

    备注

    如果“Customer”类不可用,则退出向导,生成项目,然后重新运行向导。

  8. 单击**“完成”以创建数据源并将“Customer”实体类添加到“数据源”**窗口。

创建一个 DataGridView 以在 Windows 窗体中显示 Customer 数据

通过将 LINQ to SQL 数据源项从**“数据源”**窗口拖动到 Windows 窗体上来创建绑定到实体类的控件。

添加绑定到实体类的控件

  1. 在“设计”视图中打开“Form1”。

  2. 将**“Customer”节点从“数据源”**窗口拖动到 Form1 上。

    备注

    若要显示“数据源”窗口,请单击“数据”菜单上的“显示数据源”

  3. 在代码编辑器中打开 Form1。

  4. 将下面的代码添加到该窗体中。这些代码对于该窗体是全局性的,位于任何特定方法之外,但位于 Form1 类内部:

    Private NorthwindDataContext1 As New NorthwindDataContext
    
    private NorthwindDataContext northwindDataContext1
        = new NorthwindDataContext();
    
  5. 为 Form_Load 事件创建一个事件处理程序,并将下面的代码添加到该处理程序中:

    CustomerBindingSource.DataSource = NorthwindDataContext1.Customers
    
    customerBindingSource.DataSource
        = northwindDataContext1.Customers;
    

实现保存功能

默认情况下,没有启用保存按钮,也没有实现保存功能。此外,在为对象数据源创建数据绑定控件时,不会自动添加用于将更改后的数据保存到数据库的代码。本节说明如何为 LINQ to SQL 对象启用保存按钮并实现保存功能。

实现保存功能

  1. 在“设计”视图中打开“Form1”。

  2. 在**“CustomerBindingNavigator”**上选择保存按钮(带有软盘图标的按钮)。

  3. 在**“属性”窗口中,将“Enabled”属性设置为“True”**。

  4. 双击保存按钮以创建一个事件处理程序并切换到代码编辑器。

  5. 将下面的代码添加到保存按钮事件处理程序中:

    NorthwindDataContext1.SubmitChanges()
    
    northwindDataContext1.SubmitChanges();
    

重写用于执行更新(插入、更新和删除)的默认行为

重写默认更新行为

  1. 在 O/R 设计器中打开“LINQ to SQL”文件。(在**“解决方案资源管理器”中双击“Northwind.dbml”**文件。)

  2. 在**“服务器资源管理器”/“数据库资源管理器”中,展开 Northwind 数据库的“存储过程”节点并找到“InsertCustomers”“UpdateCustomers”“DeleteCustomers”**存储过程。

  3. 将所有这三个存储过程都拖动到 O/R 设计器上。

    这些存储过程将作为 DataContext 方法添加到方法窗格中。有关更多信息,请参见 DataContext 方法(O/R 设计器)

  4. 在 O/R 设计器中选择**“Customer”**实体类。

  5. 在**“属性”窗口中选择“Insert”**属性。

  6. 单击**“使用运行时”旁的省略号 (...) 以打开“配置行为”**对话框。

  7. 选择**“自定义”**。

  8. 在**“自定义”列表中选择“InsertCustomers”**方法。

  9. 单击**“应用”**保存所选择的类和行为的配置。

    备注

    只要在每次更改后单击“应用”,就可以继续为每个类/行为组合配置行为。如果在单击“应用”之前更改类或行为,则会出现一个警告对话框,以提供一个应用任何更改的机会。

  10. 在**“行为”列表中选择“更新”**。

  11. 选择**“自定义”**。

  12. 在**“自定义”列表中选择“UpdateCustomers”**方法。

    检查**“方法参数”“类属性”列表,您会注意到,对于表中的某些列,有两个“方法参数”和两个“类属性”**。这样可以更加轻松地跟踪更改和创建检查并发冲突的语句。

  13. 将**“Original_CustomerID”方法参数映射到“CustomerID (原始)”[CustomerID (Original)]**类属性。

    备注

    默认情况下,当名称匹配时,方法参数会映射到类属性。如果属性名称发生更改并且在表与实体类之间不再匹配,则在 O/R 设计器无法确定正确的映射时,您可能必须选择等效的类属性进行映射。此外,如果方法参数没有用于进行映射的有效类属性,则可以将“类属性”值设置为“(无)”

  14. 单击**“应用”**保存所选择的类和行为的配置。

  15. 在**“行为”列表中选择“删除”**。

  16. 选择**“自定义”**。

  17. 在**“自定义”列表中选择“DeleteCustomers”**方法。

  18. 将**“Original_CustomerID”方法参数映射到“CustomerID (原始)”[CustomerID (Original)]**类属性。

  19. 单击**“确定”**。

备注

在本演练中,虽然以下事实并不会产生问题,但仍然需要注意:LINQ to SQL 会在插入和更新操作期间自动为标识(自动递增)列、rowguidcol(数据库生成的 GUID)列以及时间戳列处理数据库生成的值。在其他列类型中,数据库生成的值将意外导致 Null 值。若要返回数据库生成的值,应手动将 IsDbGenerated 设置为 true 并将 AutoSync 设置为下列值之一:AlwaysOnInsertOnUpdate

测试应用程序

再次运行应用程序以验证**“UpdateCustomers”**存储过程是否能够正确更新数据库中的客户记录。

测试应用程序

  1. 按 F5。

  2. 修改网格中的一条记录以测试更新行为。

  3. 添加一条新记录以测试插入行为。

  4. 单击保存按钮将更改保存回数据库。

  5. 关闭窗体。

  6. 按 F5 并验证是否保存了更新的记录和新插入的记录。

  7. 删除在步骤 3 中创建的新记录以测试删除行为。

  8. 单击保存按钮以提交更改并从数据库中移除已删除的记录

  9. 关闭窗体。

  10. 按 F5 并验证是否从数据库中移除了已删除的记录。

    备注

    如果您的应用程序使用 SQL Server Express Edition,则根据数据库文件的“复制到输出目录”属性值的不同,在步骤 10 中按 F5 时可能不会显示更改。有关更多信息,请参见如何:管理项目中的本地数据文件

后续步骤

根据应用程序要求的不同,您可能需要在创建 LINQ to SQL 实体类后执行几个步骤。您可以对此应用程序进行的增强包括:

请参阅

任务

如何:分配存储过程以执行更新、插入和删除(O/R 设计器)

概念

LINQ to SQL 查询

DataContext 方法(O/R 设计器)

操作的数据在Visual Studio中开发应用程序是新的2012年

其他资源

对象关系设计器(O/R 设计器)

LINQ to SQL [LINQ to SQL]