大网数据广告活动
.NET 与 C# 开发

SOAP 和 HTTP 终结点

· 52CE 我爱测

此示例演示如何实现基于 RPC 的服务并将其公开 SOAP 格式和"Plain Old XML"(POX) 格式使用 WCF Web 编程模型中。 请参阅基本 HTTP 服务示例服务的 HTTP 绑定有关的详细信息。 本示例重点介绍有关使用不同绑定通过 SOAP 和 HTTP 公开相同服务的详细信息。

此示例演示如何实现基于 RPC 的服务并将其公开 SOAP 格式和"Plain Old XML"(POX) 格式使用 WCF Web 编程模型中。 请参阅基本 HTTP 服务示例服务的 HTTP 绑定有关的详细信息。 本示例重点介绍有关使用不同绑定通过 SOAP 和 HTTP 公开相同服务的详细信息。

演示

通过 SOAP 和 HTTP 使用 WCF 公开 RPC 服务。

讨论

此示例由两个组件组成: 一个包含 WCF 服务和调用服务操作使用 SOAP 和 HTTP 绑定的控制台应用程序 (客户端) 的 Web 应用程序项目 (服务)。

WCF 服务公开 2 个操作 –GetData和PutData– 后者回显作为输入传递的字符串。 这些服务操作使用 xref:System.ServiceModel.Web.WebGetAttribute 和 xref:System.ServiceModel.Web.WebInvokeAttribute 进行批注。 这些特性控制这些操作的 HTTP 投影。 此外,这些操作使用 xref:System.ServiceModel.OperationContractAttribute 进行批注,从而使其可以通过 SOAP 绑定进行公开。 服务的 PutData 方法引发 xref:System.ServiceModel.Web.WebFaultException,该异常使用 HTTP 状态代码通过 HTTP 发回,通过 SOAP 作为 SOAP 错误发回。

Web.config 文件配置包含 3 个终结点的 WCF 服务:

  • ~/service.svc/mex 终结点,公开服务元数据供基于 SOAP 的客户端访问。

  • ~/service.svc/http 终结点,使客户端可以使用 HTTP 绑定访问服务。

  • ~/service.svc/soap 终结点,使客户端可以使用 SOAP over HTTP 绑定访问服务。

HTTP 终结点配置与 <webHttp> 标准终结点具有helpEnabled设置为true。 因此,服务在 ~/service.svc/http/help 上公开基于 XHTML 的页面,基于 HTTP 的客户端可以使用该页面访问服务。

客户端项目演示如何访问服务使用 SOAP 代理 (通过生成添加服务引用) 和访问服务使用xref:System.Net.WebClient。

该示例包含一个 Web 承载的服务和一个控制台应用程序。 在控制台应用程序运行时,客户端会对服务进行请求,并将响应中的相关信息写入控制台窗口。

运行示例
  1. 打开 SOAP 和 HTTP 终结点示例的解决方案。

  2. 按 Ctrl+Shift+B 生成解决方案。

  3. 如果尚未打开,请按 CTRL + W,S 打开解决方案资源管理器窗口。

  4. 从解决方案资源管理器窗口中,右键单击服务项目,然后将光标放调试上下文菜单选项,以便新启动实例出现上下文菜单。 单击启动新实例。 这将启动承载服务的 ASP.NET 开发服务器。

  5. 从解决方案资源管理器窗口中,右键单击客户端项目,然后将光标放调试上下文菜单选项,以便启动新实例出现上下文菜单。 单击启动新实例。

  6. 出现客户端控制台窗口,该窗口提供了正在运行的服务的 URI,以及该服务的 HTML 帮助页的 URI。 可随时通过在浏览器中键入 HTML 帮助页的 URI 来查看该帮助页。

  7. 在示例运行时,客户端将写入当前活动的状态。

  8. 按任意键可终止客户端控制台应用程序。

  9. 按 Shift+F5 可停止调试服务。

  10. 在 Windows 通知区域中,右键单击 ASP.NET 开发服务器图标,然后选择停止从上下文菜单。

Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:

<InstallDrive>:\WF_WCF_Samples

如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\SoapAndHttpEndpoints

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。