SOAP 和 HTTP 终结点

本示例演示如何使用 WCF Web 编程模型实现基于 RPC 的服务并以 SOAP 格式和“Plain Old XML”(POX) 格式进行公开。有关服务的 HTTP 绑定的更多详细信息，请参见基本 HTTP 服务示例。本示例重点介绍有关使用不同绑定通过 SOAP 和 HTTP 公开相同服务的详细信息。

演示

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

讨论

本示例由两个组件组成：一个包含 WCF 服务的 Web 应用程序项目（服务），以及一个使用 SOAP 和 HTTP 绑定调用服务操作的控制台应用程序（客户端）。

WCF 服务公开 2 个操作：GetData 和 PutData，后者回显作为输入传递的字符串。这些服务操作使用 WebGetAttribute 和 WebInvokeAttribute 进行批注。这些特性控制这些操作的 HTTP 投影。此外，这些操作使用 OperationContractAttribute 进行批注，从而使其可以通过 SOAP 绑定进行公开。服务的 PutData 方法引发 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 代理（通过**“添加服务引用”**生成）访问服务以及如何使用 WebClient 访问服务。

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

运行示例

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

2. 按 F6 生成解决方案。

3. 如果它尚未打开，请按 Ctrl+W 再按 S 打开**“解决方案资源管理器”**窗口。

4. 在**“解决方案资源管理器”窗口中，右击“服务”项目，将光标放在“调试”上下文菜单选项上以显示“启动新实例”上下文菜单。单击“启动新实例”**。这将启动承载该服务的 ASP.NET 开发服务器。

5. 在“解决方案资源管理器”窗口中，右击客户端项目，将光标放在**“调试”上下文菜单选项上以显示“启动新实例”上下文菜单。单击“启动新实例”**。

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

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

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

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

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

注意：
您的计算机上可能已安装这些示例。在继续操作之前，请先检查以下（默认）目录。 <安装驱动器>:\WF_WCF_Samples 如果此目录不存在，请访问针对 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例（可能为英文网页），下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录。 <安装驱动器>:\WF_WCF_Samples\WCF\Basic\Web\SoapAndHttpEndpoints