在 .NET 中使用 WCF 如何让它像 ASMX 一样自动生成 SOAP 文档？答案

【问题标题】：Using WCF in .NET how can I make it auto generate SOAP docs like ASMX did?在 .NET 中使用 WCF 如何让它像 ASMX 一样自动生成 SOAP 文档？
【发布时间】：2010-06-07 07:49:54
【问题描述】：

我目前正在使用 VB.NET 中的 WCF 编写 Web 服务。

我之前编写的 Web 服务使用的是 ASMX，但我想学习 WCF，目前进展顺利。我实际上更喜欢 WCF 做事的方式。

然而，我想念的一件事是 ASMX 用于生成示例 SOAP 请求和响应的方式。就像免费获得文档一样。

是否可以为 WCF 自动生成 SOAP 文档？

如果没有，有没有办法使用 WSDL 在 .NET 页面中生成它？

【问题讨论】：

标签： asp.net wcf soap wsdl documentation-generation

【解决方案1】：

我猜 WCF 不像 ASMX 那样支持这一点，因为 WCF 支持多种端点类型，而不仅仅是 SOAP Web 服务（例如 Net TCP、命名管道等）。

SoapUI 是一个很好的小工具，可以从 WSDL 自动生成 SOAP 消息。或者，您可以创建一个小型测试客户端应用，启用 WCF 跟踪，然后使用 Service Trace Viewer Tool 查看发送的消息。

【讨论】：

我正在寻找的是可以动态自动生成文档的东西，这样如果我向我的 API 添加新方法，它们会自动记录下来并给出一些 sapd 示例.. 有没有.net 库执行此操作？

【解决方案2】：

我终于找到了答案。 WCFExtras。 WCFExtras 库允许您使用 XML cmets 记录您的 API，它读取这些 cmets 并将它们作为文档 cmets 插入 WSDL。然后，我们阅读此内容并使用名为 TechWriter 的应用程序生成 HTML 文档。

【讨论】：