如何在 .Net 中为 SOAP/WebService 类生成 HTML 文档？答案

【问题标题】：How can I generate HTML documentation for a SOAP/WebService class in .Net?如何在 .Net 中为 SOAP/WebService 类生成 HTML 文档？
【发布时间】：2010-10-13 15:44:16
【问题描述】：

当您在 VisualStudio(VS) 中启动 WebService 项目时，您确实会看到一些 HTML 文档，但 C# 注释帮助不会将其传递到 HTML。您可以通过使用 WebMethod 属性的 Description 属性来获得每个 Web 方法的描述，但这意味着从注释帮助中复制文本，并且据我所知也不允许记录 Web 方法参数。

有没有一种简单的方法来获取 C# 代码中已经存在的注释帮助？

谢谢。

【问题讨论】：

这就是为什么会有投票按钮！

标签： .net soap wsdl

【解决方案1】：

C# cmets 不会被编译到程序集中。有一个solution over at Codeproject 用于提供备用 WSDL 文档：设置 ASP.NET 应用程序来读取原始 xml 文档文件应该不会太难，并通过一些配置将 WSDL 服务和操作与类和方法相匹配。

不过，我不知道是否有现成的解决方案可以解决您的问题。

【讨论】：

【解决方案2】：

我们现在使用 WCFExtra 库将我代码中的 XML cmets 转换为 WSDL 中的文档 cmets。

从那里我们使用 TechWriter 来构建文档。

【讨论】：

请不要写 cmets 作为答案。