为 xml Web services 添加 Web 引用。
编写代码以访问 xml Web services.在调试模式下运行 Web 应用程序。
部署 Web 应用程序。
要完成演练,必须提供以下内容:
由于本演练使用了一个 Web 应用程序来访问 xml Web services,因此您必须提供满足创建 Web 项目的要求的计算机。有关更多信息,请参见asp">创建 Web 项目和 asp">Visual Studio .NET 软件要求。要在 Web 服务器所在的计算机上创建 xml Web services 项目,您同样需要具有足够的权限。有关详细信息,请参见 asp">Visual Studio 中设计时的 Web 应用程序安全性。
由下列演练之一创建的 xml Web services:asp">演练:使用 Visual Basic 或 Visual C# 创建 xml Web services asp">演练:使用 ATL Server 创建 xml Web services asp">演练:使用 C++ 托管扩展创建 xml Web services创建 xml Web services 客户端项目在本演练中,您将创建一个简单的 Web 应用程序,该应用程序将访问 TempConvert1 xml Web services(这是赋予asp">演练:使用 Visual Basic 或 Visual C# 创建 xml Web services 中创建的 xml Web services 的名称)。
注意 若要访问温度转换 xml Web services 的不同实现,只需在此演练的整个过程中将出现的名称 TempConvert1 替换为相应的名称。
创建 ASP.NET Web 应用程序
在“文件”菜单上指向“新建”,然后单击“项目”以打开“新建项目”对话框。
展开“Visual Basic 项目”或“Visual C# 项目”文件夹。
单击“ASP.NET Web 应用程序”图标。
输入要在其中开发 Web 应用程序的 Web 服务器地址,并指定 TempConvertClient1 作为目录名,如“http://MyServer/TempConvertClient1”。默认情况下,项目使用本地计算机“http://localhost”。
注意 对于某些项目类型,“名称”文本框不可用,因为在指定位置时就设置了项目名。例如,Web 应用程序和 xml Web services 位于 Web 服务器上,它们的名称从该服务器上指定的虚拟目录导出。
注意 您是在开发服务器上开发 Web 应用程序。默认情况下,开发服务器是本地计算机。通常,在开发服务器上开发和生成项目,然后使用部署项目将其部署到承载该 Web 应用程序的另一服务器(部署服务器)上。但是,如果直接在将承载该 Web 应用程序的服务器上进行开发,则开发服务器与部署服务器相同。
单击“确定”创建项目。
从“工具箱”的“Web 窗体”选项卡中,将“文本框”、“标签”和“按钮”拖动到 WebForm1.aspx 的设计图面上,然后按您的喜好排列它们。
右击您添加的按钮 Button1,然后在快捷菜单上单击“属性”。在“属性”窗口中,将 Text 属性设置为 Convert.右击您添加的标签 Label1,然后在快捷菜单上单击“属性”。在“属性”窗口中,清除 Text 属性以使此标签成为空白标签。
添加 Web 引用xml Web services 发现是客户端定位 xml Web services 和获取其服务说明的过程。Visual Studio 中的 xml Web services 发现过程涉及按照预先确定的算法询问 Web 站点。该过程的目的是定位服务说明,服务说明是使用 Web 服务描述语言 (WSDL) 的 xml 文档。有关更多信息,请参见 asp">xml Web services 发现。
服务说明描述哪些服务可用以及如何与这些服务交互。没有服务说明便无法以编程方式与 xml Web services 交互。有关更多信息,请参见 asp">xml Web services 说明。
应用程序必须具有与 xml Web services 通信和在运行时找到该服务的方法。向项目添加对 xml Web services 的 Web 引用是通过生成一个代理类来完成此操作的,该代理类与 xml Web services 进行接口操作并提供 xml Web services 的本地表示形式。有关更多信息,请参见 asp">Web 引用和asp">生成 xml Web services 代理。
添加 Web 引用
在“项目”菜单上单击“添加 Web 引用”。
在“添加 Web 引用”对话框的“URL”框中,键入 URL 以获得要访问的 xml Web services 的服务说明,如 ttp://localhost/TempConvert1/Service1.asmx.然后单击“执行”按钮以检索有关该 xml Web services 的信息。
- 或 -
如果该 xml Web services 位于本地计算机上,请单击浏览器窗格中的“本地计算机上的 Web 服务”链接。然后,从所提供的列表中单击 TempConvert1 xml Web services 链接以检索有关该 xml Web services 的信息。
在“Web 引用名”框中,将 Web 引用重命名为 ConvertSvc(它就是将用于该 Web 引用的命名空间)。
单击“添加引用”为目标 xml Web services 添加 Web 引用。有关更多信息,请参见asp">添加和移除 Web 引用。
Visual Studio 将下载服务说明并生成一个作为应用程序和 xml Web services 之间的接口的代理类。
访问 xml Web services一旦将 xml Web services 的引用添加到项目中,下一步就是创建 xml Web services 代理类的实例。然后就可以按照与访问任意对象的方法相同的方式,通过调用代理类中的方法来访问 xml Web services 的方法。当应用程序调用这些方法时,由 Visual Studio 生成的代理类代码将处理应用程序与 xml Web services 之间的通信。
首先,创建 xml Web services 代理类的实例。接下来,将接受一个在 TextBox1 中提供的值,然后使用该代理类对 xml Web services 的 ConvertTemperature 方法进行调用。然后在 Label1 中显示从 xml Web services 中返回的值。
在 WebForm1.aspx 上双击“转换”按钮,为该按钮创建事件处理方法并显示代码隐藏文件。
注意 默认情况下,解决方案资源管理器会隐藏代码隐藏文件。在解决方案资源管理器工具栏中单击“显示所有文件”查看隐藏文件。或者,在“项目”菜单上单击“显示所有文件”。
输入下列代码:' Visual Basic Private Sub Button1_Click(ByVal sender As Object, _ ByVal e as EventArgs) Handles Button1.Click Dim ws As New ConvertSvc.Service1()
Dim dFahrenheit As Double Dim dCelsius As Double Try dFahrenheit = Convert.ToDouble(TextBox1.Text)
dCelsius = ws.ConvertTemperature(dFahrenheit)
Label1.Text = dCelsius.ToString()
Catch Label1.Text = "Conversion failed." End Try End Sub // C# protected void Button1_Click (System.Object sender, System.EventArgs e)
{ try { ConvertSvc.Service1 ws = new ConvertSvc.Service1();double dFahrenheit = Convert.ToDouble(TextBox1.Text);double dCelsius = ws.ConvertTemperature(dFahrenheit);Label1.Text = dCelsius.ToString();} catch { Label1.Text = "Conversion failed.";}注意 添加 Web 引用时生成的 xml Web services 类的名称可能与上面显示的 Service1 名称不同。
在解决方案资源管理器中选择 WebForm1.aspx.在“项目”菜单上指向“Web 项目”,然后单击“设为起始页”。
保存解决方案。
有关更多信息,请参见asp">访问托管代码中的 xml Web services.
调试 xml Web services 客户端Visual Studio 提供了若干方法,用于从 IDE 生成并运行 Web 应用程序,如:
开始执行(带调试)
开始执行(不调试)
在浏览器中查看作为 Visual Studio 项目,此 Web 应用程序的发布版本和调试版本的配置不同。由于创建此项目时使用的是 ASP.NET Web 应用程序项目模板,因此 Visual Studio 自动创建这些配置并设置适当的默认选项和其他设置。有关更多信息,请参见asp">调试和发布配置。
本演练中,您将在 Button1_Click 事件中放置一个断点,并将使用“开始执行(带调试)”方法。有关更多信息,请参见asp">调试托管代码中的 xml Web services.
调试前,请验证调试设置。有关更多信息,请参见asp">调试准备:ASP.NET Web 应用程序。
使用断点和启动 Web 应用程序,并进行调试
在“调试”菜单上单击“新断点”。
在“函数”选项卡的“函数”框中键入 Button1_Click,并单击“确定”在 Button1_Click 事件处理程序中放置一个断点。有关更多信息,请参见asp">“新断点”对话框。
在“调试”菜单上单击“启动”。
该命令指示 Visual Studio 在调试器中运行 Web 应用程序。Visual Studio 生成项目并将其部署到指定的开发服务器中。完成后,将启动默认浏览器并导航到部署服务器上的 .aspx 文件。
在“调试”菜单上,单击“停止调试”停止运行 Web 应用程序并返回到代码编辑器。
当页显示在浏览器中之后,在文本框中键入数字 212,然后单击“转换”按钮。
当处理到达 Button1_Click 事件处理程序时,处理停止。Visual Studio 调试器突出显示包含断点的行,在该调试器暂停时,您可以执行各种任务。有关更多信息,请参见asp">使用调试器和asp">用于检查程序的调试工具。
在“调试”菜单上单击“继续”可继续进行处理。
xml Web services 以返回转换值的形式做出响应,并且应用程序将 Label1 的文本设置为 100.若要停止运行该 Web 应用程序并返回到代码编辑器中,请在“调试”菜单上单击“停止调试”。
在“调试”菜单上单击“清除所有断点”。
部署客户端若要使 Web 应用程序可由他人使用,必须将其部署到客户端(您希望支持该客户端进行访问)可访问的 Web 服务器。若要将 Web 应用程序部署到开发服务器以外的服务器,可以添加 Web 安装项目或者将所需的文件复制到目标服务器。本演练中,可以选择如何部署此 Web 应用程序。有关更多信息,请参见asp">部署应用程序和组件。
使用 Web 安装项目部署 Web 应用程序
在“文件”菜单上指向“添加项目”,然后单击“新建项目”。
选择“安装和部署项目”文件夹,然后单击“Web 安装项目”。
在“名称”框中键入 TempConvertClient1WebSetup,然后单击“确定”。
注意 默认情况下,在部署服务器上创建虚拟目录时,安装程序将使用部署项目名称。
在“文件系统编辑器”的左窗格中选择“Web 应用程序文件夹”。有关更多信息,请参见asp">文件系统编辑器。
在“解决方案资源管理器”中右击 TempConvertClient1WebSetup,指向“添加”,然后单击“项目输出”。
在“添加项目输出组”对话框中,选择“内容文件”、“主输出”和“调试符号”。有关更多信息,请参见asp">在文件系统编辑器中添加和移除项目输出。
“内容文件”组由 Web 应用程序的其余文件(如 WebForm1.aspx 和 Web.config)组成。
“主输出”组由项目 DLL TempConvertClient1.dll 及其依赖项组成。
“调试符号”组由项目 PDB 文件 TempConvertClient1.pdb 组成。
单击“确定”。
在“解决方案资源管理器”中,右击 TempConvertClient1WebSetup 项目,然后在快捷菜单上单击“生成”。
该操作将在本地项目目录中创建一个 Windows 安装程序文件。执行该文件即可安装 Web 应用程序。
通过复制项目来部署 Web 应用程序
在“解决方案资源管理器”中,选择 TempConvertClient1 项目。
在“项目”菜单上,单击“复制项目”。
在“目标项目文件夹”框中输入要将该项目复制到的位置。
单击“FrontPage”或“文件共享”以选择“Web 访问方法”。有关更多信息,请参见asp">更改 Web 项目访问方法。
单击“仅限于运行该应用程序所需的文件”。
单击“确定”。