演练：仅使用存储过程 (C#) (LINQ to SQL)

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

注意
您还可以在 LINQ to SQL 应用程序中使用存储过程来重写默认行为，尤其是 Create、Update 和 Delete 进程的默认行为。有关更多信息，请参见自定义插入、更新和删除操作 (LINQ to SQL)。

出于本演练的需要，您将用到已映射到 Northwind 示例数据库中存储过程的两个方法：CustOrdersDetail 和 CustOrderHist。 此映射发生在运行 SqlMetal 命令行工具来生成 C# 文件时。 有关更多信息，请参见本演练后面的“先决条件”一节。

本演练不依赖于对象关系设计器。 使用 Visual Studio 的开发人员还可以使用 O/R 设计器 来实现存储过程功能。 有关更多信息，请参见 对象关系设计器（O/R 设计器） 和 对象关系设计器（O/R 设计器） 和 对象关系设计器（O/R 设计器）.

注意
对于在以下说明中使用的某些 Visual Studio 用户界面元素，您的计算机可能会显示不同的名称或位置。这些元素取决于您所使用的 Visual Studio 版本和您所使用的设置。有关更多信息，请参见 Visual Studio 设置。

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

系统必备

本演练需要如下内容：

• 本演练使用专用文件夹（“c:\linqtest7”）来保存文件。 请在开始本演练前创建此文件夹。

• Northwind 示例数据库。

  如果您的开发计算机上没有此数据库，您可以从 Microsoft 下载网站下载它。 有关说明，请参见下载示例数据库 (LINQ to SQL)。 下载此数据库后，请将 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 程序集引用

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

添加 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[Design]”）。

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

   工具箱即会打开。

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

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

   按照附图排列这些控件。 扩展**“Form1”**，让控件更便于显示。

4. 右击**“label1”，然后单击“属性”**。

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

6. 对于**“label2”，请按相同的方式将“Text”属性从“label2”更改为“Enter CustomerID:”**。

7. 按相同的方式，将**“button1”的“Text”属性更改为“Order Details”**。

8. 将**“button2”的“Text”属性更改为“Order History”**。

   将这些按钮控件加宽，以使所有文本均可见。

处理按钮单击

1. 双击**“Form1”上的“Order Details”（订单明细）**在代码编辑器中打开 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 = "";
   

测试应用程序

现在，可以开始测试您的应用程序了。 请注意，您可对数据存储施加的影响仅限于这两个存储过程能够执行的操作。 这些操作是要根据您输入的所有 orderID 返回相应订单包括的产品，或根据您输入的所有 CustomerID 返回相应客户的产品订购历史记录。

测试应用程序

1. 按 F5 开始调试。

   此时将显示 Form1。

2. 在**“Enter OrderID”（输入 OrderID）框中，键入“10249”，然后单击“Order Details”（订单明细）**。

   随即会显示一个消息框，其中列出了 10249 号订单中所包括的产品。

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

3. 在**“Enter CustomerID”（输入 CustomerID）框中，键入 ALFKI，然后单击“Order History”（订单历史记录）**。

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

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

4. 在**“Enter OrderID”（输入 OrderID）框中，键入 123，然后单击“Order Details”（订单明细）**。

   随即会显示一个消息框，其中显示“无结果”。

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

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

   调试会话即会关闭。

6. 如果您已试验完毕，可以单击**“文件”菜单上的“关闭项目”**，并在看到相应提示时保存您的项目。

后续步骤

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

请参见

概念

通过演练学习 (LINQ to SQL)

其他资源

存储过程 (LINQ to SQL)