WCF服务参考不包括原始服务方法的注释

Question

我使用一种方法创建了一个简单的 WCF Web 服务。这个方法有注释。

为什么注释没有出现在消费应用程序的服务参考中？

是否有其他方法可以将方法注释传播到代理？

/// <summary>
/// Do some work 
/// </summary>
public void DoWork()
{
}

Answer 1

它不会出现在服务参考中，因为注释不是服务元数据的一部分。您可以使用两个选项来使注释显示在代理上：

• 共享服务器和客户端之间的合约接口（即，不生成代理，而只是在客户端重用您的接口）。
• 使用一些可识别注释（或其他属性）的自定义 WSDL 导出扩展，以及在生成客户端时可以理解这些注释的自定义 WSDL 导入扩展。示例位于 http://msdn.microsoft.com/en-us/library/ aa717040.aspx 是一种可能的实现。

Answer 2

也许 WCF Extras 适合您。听起来像是你想要的。

“从源代码 XML 注释添加 WSDL 文档”

Answer 3

确保您的服务参考标记为内部而不是公共，警告就会消失。