本文演示如何一步一步创建和测试将 DataSet 对象返回到客户端的 Web 服务。 本文还演示如何在客户端应用程序中引用 Web 服务并在 DataGrid 控件中显示返回的 DataSet。
本文中的代码示例使用 http://localhost 作为 Web 服务器。 代码示例仍然使用罗斯文 (Northwind) 数据库,该数据库作为后端数据库包括在 Microsoft SQL Server 中。
创建 Web 服务
<script type="text/javascript">loadTOCNode(2, 'summary');</script>
1. | 打开 Microsoft Visual Studio .NET。 |
2. | 从文件菜单中,指向新建,然后单击项目。 |
3. | 在新建项目对话框中,单击项目类型下的 Visual C#,然后单击模板下的 ASP.NET Web 服务。 |
4. | 在名称文本框中,键入 csCustomer。 在位置文本框中,键入到您的服务器的 URL。 如果您使用的是本地服务器,则键入 http://localhost。单击确定。 |
5. | 从视图菜单中,单击代码以切换到代码视图。 |
6. | 将以下代码添加到“代码”窗口顶部紧挨在其他 using 语句之后: //Use data access objects from the SqlClient namespace.using System.Data.SqlClient; |
7. | 找到以下代码: public Service1() {//CODEGEN: This call is required by the ASP.NET Web Services Designer.InitializeComponent(); } 在上述代码之后添加以下代码: [WebMethod] public string CountWords(string Sentence) { string[] Words = Sentence.Split(' '); return "Your sentence contains " + Words.Length + " word(s)."; }[WebMethod] public DataSet GetCustOrders(string IDMask) { IDMask = IDMask.Replace("'", "''");//IDMask is the Customer ID that the client submits.//Replace single quotation marks with two single quotation marks//so that all single quotation marks in the CustomerID are parsed correctly.//Modify this connection string to use your SQL Server and log on information.SqlConnection con = new SqlConnection("server=<your server>;uid=<your user id>; pwd=<your Password>;database=northwind");//Open the Customers table to serve as the parent table.SqlDataAdapter daCust = new SqlDataAdapter("Select * From Customers Where CustomerID Like '%" + IDMask + "%'", con);//Open the Orders table to serve as the child table.SqlDataAdapter daOrders = new SqlDataAdapter("Select * From Orders Where CustomerID Like '%" + IDMask + "%'", con);//Create a client-side DataSet to hold the Customers and Orders tables.DataSet ds=new DataSet();//Explicitly open the connection to allow explicit closing.con.Open();//Fill the DataSet with the Customers table and the Orders table.daCust.Fill(ds, "Cust");daOrders.Fill(ds, "Orders");//Explicitly close the connection - don't wait for garbage collection.con.Close();//Relate Customers to Orders.ds.Relations.Add("CustOrd", ds.Tables["Cust"].Columns["CustomerID"], ds.Tables["Orders"].Columns["CustomerID"]);//The relationship is Orders nested within Customers.ds.Relations[0].Nested = true;//Return the DataSet to the client.return ds;} |
8. | 根据您的环境相应地修改 SqlConnection 字符串。 |
测试 Web 服务
<script type="text/javascript">loadTOCNode(2, 'summary');</script>
1. | 按 F5 键以编译并运行 Web 服务。将返回一个 Web 页,它允许您在 Microsoft Internet Explorer 中与 Web 服务进行交互。
请注意,返回页的 URL 是 http://localhost/csCustomer/Service1.asmx。 |
2. | 在 Service1 Web 页上,单击 GetCustOrders。 将返回一个 Web 页,其中显示关于 GetCustOrders Web 方法的详细信息。
请注意,返回页的 URL 是 http://localhost/csCustomer/Service1.asmx?op=GetCustOrders。 |
3. | 在 GetCustOrders 页的文本部分,在 IDMask 参数旁边的值文本框中键入 AL。 |
4. | 单击调用。 将返回一个 Web 页,它以分层可扩展标记语言 (XML) 文档的形式显示 GetCustOrders Web 方法的结果。
请注意,返回页的 URL 是 http://localhost/csCustomer/Service1.asmx/GetCustOrders?IDMask=AL。 |
5. | 关闭显示的 Web 页。 |
创建客户端应用程序
<script type="text/javascript">loadTOCNode(2, 'summary');</script>
1. | 在 Visual Studio .NET 中,新建一个 Visual C# Windows 应用程序项目。Form1 在默认情况下被添加到项目中。 |
2. | 在 Form1 中添加一个 TextBox 控件、一个 Button 控件和一个 DataGrid 控件。 TextBox1、Button1 和 DataGrid1 在默认情况下会被添加到该项目中。 |
3. | 从项目菜单中,单击添加 Web 引用。 将出现一个显示 Web 引用来源的对话框。 |
4. | 在添加 Web 引用对话框中,键入 Web 服务的 URL(例如,http://localhost/csCustomer/Service1.asmx),按 ENTER 键,然后单击添加引用。 请注意,在解决方案资源管理器中出现一个名为 Web 引用的新项。 |
5. | 在 Visual C# 项目中,双击 Button1 以打开其“代码”窗口,然后将以下代码粘贴到 Button1_Click 事件处理程序中: //Use the Web Service that your Web server provides. localhost.Service1 MyService = new localhost.Service1(); //Invoke the public WebMethod that returns a DataSet. //Bind the DataGrid to the returned DataSet. dataGrid1.DataSource = MyService.GetCustOrders(textBox1.Text);dataGrid1.DataMember = "Cust"; |
测试客户端应用程序
<script type="text/javascript">loadTOCNode(2, 'summary');</script>
1. | 按 F5 键以编译并运行客户端应用程序。 |
2. | 在文本框中键入 AL。 |
3. | 单击 Button1。 请注意,DataGrid1 显示 CustomerID 字段中包含“AL”的客户记录。 |
4. | 在 DataGrid1 中,单击 ALFKI 旁边的加号 (+),以显示在 Web 方法中定义的 CustOrd 关系。 |
5. | 单击 CustOrd,以便按照 CustomerID ALKFI 显示与客户有关的订单。 |