演练:仅使用存储过程 (C#)

本演练提供基本的端到端 LINQ to SQL 方案,用于仅执行存储过程来访问数据。 数据库管理员通常使用此方法来限制数据存储的访问方式。

注释

你还可以在 LINQ to SQL 应用程序中使用存储过程来重写默认行为,尤其是 Create、Update 和 Delete 进程的默认行为。 有关详细信息,请参阅 自定义插入、更新和删除操作。

在本演练中,你将使用两种方法,这些方法已映射到 Northwind 示例数据库中的存储过程:CustOrdersDetail 和 CustOrderHist。 运行 SqlMetal 命令行工具生成 C# 文件时,会发生映射。 有关详细信息,请参阅本演练后面的“先决条件”部分。

本演练不依赖于对象关系设计器。 使用 Visual Studio 的开发人员还可以使用 O/R 设计器来实现存储过程功能。 请参阅 Visual Studio 中的 LINQ to SQL 工具。

注释

计算机可能会在以下说明中显示某些 Visual Studio 用户界面元素的不同名称或位置。 你拥有的 Visual Studio 版本以及所使用的设置决定了这些元素。 有关更多信息,请参阅 自定义 IDE。

本演练是使用 Visual C# 开发设置编写的。

先决条件

本演练需要如下内容:

  • 本演练使用专用文件夹(“c:\linqtest7”)保存文件。 在开始演练之前创建此文件夹。

  • Northwind 示例数据库。

    如果开发计算机上没有此数据库,可以从Microsoft下载站点下载它。 有关说明,请参阅 下载示例数据库。 下载数据库后,将northwnd.mdf文件复制到 c:\linqtest7 文件夹。

  • 从 Northwind 数据库生成的 C# 代码文件。

    本演练使用 SqlMetal 工具并通过以下命令行编写:

    sqlmetal /code:“c:\linqtest7\northwind.cs” /language:csharp “c:\linqtest7\northwnd.mdf” /sprocs /functions /pluralize

    有关详细信息,请参阅 SqlMetal.exe(代码生成工具)。

概述

本演练由六个主要任务组成:

  • 在 Visual Studio 中设置 LINQ to SQL 解决方案。

  • 将 System.Data.Linq 程序集添加到项目。

  • 将数据库代码文件添加到项目。

  • 创建与数据库的连接。

  • 设置用户界面。

  • 运行并测试应用程序。

创建 LINQ to SQL 解决方案

在此第一个任务中,你将创建一个 Visual Studio 解决方案,其中包含生成和运行 LINQ to SQL 项目所需的引用。

创建 LINQ to SQL 解决方案

  1. 在 Visual Studio 文件 菜单上,指向 “新建”,然后单击“ 项目”。

  2. 在“新建项目”对话框中的“项目类型”窗格中,单击“Visual C#”。

  3. 在 “模板 ”窗格中,单击 “Windows 窗体应用程序”。

  4. 在 “名称 ”框中,键入 SprocOnlyApp。

  5. 在 “位置” 框中,验证要存储项目文件的位置。

  6. 单击 “确定” 。

    Windows 窗体设计器随即打开。

添加 LINQ to SQL 程序集引用

标准 Windows 窗体应用程序模板中不包括 LINQ to SQL 程序集。 您将需要按照以下步骤中的说明自行添加此程序集:

添加 System.Data.Linq.dll

  1. 在解决方案资源管理器中,右键点击引用,然后点击添加引用。

  2. 在“ 添加引用 ”对话框中,单击 .NET,单击 System.Data.Linq 程序集,然后单击“ 确定”。

    此程序集即被添加到项目中。

将 Northwind 代码文件添加到项目

此步骤假定你已使用 SqlMetal 工具从 Northwind 示例数据库生成代码文件。 有关详细信息,请参阅本演练前面的先决条件部分。

将 “northwind” 代码文件添加到项目中

  1. 在 项目 菜单上,单击 添加现有项。

  2. 在 “添加现有项 ”对话框中,移动到 c:\linqtest7\northwind.cs,然后单击“ 添加”。

    northwind.cs文件将添加到项目中。

创建数据库连接

在此步骤中,定义与 Northwind 示例数据库的连接。 本演练使用“c:\linqtest7\northwnd.mdf”作为路径。

创建数据库连接

  1. 在 解决方案资源管理器中,右键单击 Form1.cs,然后单击“ 查看代码”。

  2. 在类中 Form1 键入以下代码:

    Northwnd db = new Northwnd(@"c:\linqtest7\northwnd.mdf");
    

设置用户界面

在此任务中,你设置了一个接口,以便用户可以执行存储过程来访问数据库中的数据。 在通过本演练开发的应用程序中,用户只能使用应用程序中嵌入的存储过程访问数据库中的数据。

设置用户界面

  1. 返回到 Windows 窗体设计器(Form1.cs[设计])。

  2. 在“视图”菜单上,单击“工具箱”。

    工具箱随即打开。

    注释

    单击“自动隐藏”图钉,以使工具箱在你执行本节中剩余步骤的过程中保持打开。

  3. 将工具箱中的两个按钮、两个文本框和两个标签拖到 Form1 上。

    按照随附插图中的说明排列控件。 展开 Form1 ,使控件易于适应。

  4. 右键单击 label1,然后单击“ 属性”。

  5. 将 Text 属性从 label1 更改为 Enter OrderID:。

  6. 在 label2 中,将 Text 属性从 label2 更改为 Enter CustomerID:。

  7. 同样,将 button1 的 Text 属性更改为“订单详细信息”。

  8. 将 button2 的 Text 属性更改为“订单历史记录”。

    扩大按钮控件,使所有文本可见。

处理按钮单击

  1. 双击 Form1 上的“订单详细信息”,在代码编辑器中打开 button1 事件处理程序。

  2. 请在处理器 button1 中键入以下代码:

    // Declare a variable to hold the contents of
    // textBox1 as an argument for the stored
    // procedure.
    string param = textBox1.Text;
    
    // Declare a variable to hold the results
    // returned by the stored procedure.
    var custquery = db.CustOrdersDetail(Convert.ToInt32(param));
    
    // Execute the stored procedure and display the results.
    string msg = "";
    foreach (CustOrdersDetailResult custOrdersDetail in custquery)
    {
        msg = msg + custOrdersDetail.ProductName + "\n";
    }
    if (msg == "")
        msg = "No results.";
    MessageBox.Show(msg);
    
    // Clear the variables before continuing.
    param = "";
    textBox1.Text = "";
    
  3. 现在双击 Form1 上的 button2 打开button2处理程序

  4. 请在处理器 button2 中键入以下代码:

    // Comments in the code for button2 are the same
    // as for button1.
    string param = textBox2.Text;
    
    var custquery = db.CustOrderHist(param);
    
    string msg = "";
    foreach (CustOrderHistResult custOrdHist in custquery)
    {
        msg = msg + custOrdHist.ProductName + "\n";
    }
    MessageBox.Show(msg);
    
    param = "";
    textBox2.Text = "";
    

测试应用程序

现在是时候测试应用程序了。 请注意,您与数据存储的接触仅限于两个存储过程可以采取的任何操作。 这些动作是针对输入的任何订单ID返回包含的产品,或针对输入的任何客户ID返回订购产品的历史记录。

测试应用程序

  1. 按 F5 开始调试。

    此时会显示 Form1。

  2. 在 “Enter OrderID ”框中,键入 10249,然后单击“ 订单详细信息”。

    消息框列出了 10249 订单中包含的产品。

    单击“ 确定” 关闭消息框。

  3. 在 “输入 CustomerID ”框中,键入 ALFKI,然后单击“ 订单历史记录”。

    此时会显示一个消息框,其中列出了客户 ALFKI 的订单历史记录。

    单击“ 确定” 关闭消息框。

  4. 在 “Enter OrderID ”框中,键入 123,然后单击“ 订单详细信息”。

    此时会显示一个显示“无结果”的消息框。

    单击“ 确定” 关闭消息框。

  5. 在 “调试 ”菜单上,单击“ 停止调试”。

    调试会话将关闭。

  6. 如果已完成试验,可以在“文件”菜单上单击“关闭项目”,并在系统提示时保存项目。

后续步骤

可以通过进行一些更改来增强此项目。 例如,可以在列表框中列出可用的存储过程,并让用户选择要执行哪些过程。 您还可以将报告的输出以流的方式传输到文本文件。

另请参阅