web-services - 将摘要标记添加到生成的 Web 服务代理类的最佳方法是什么？

Question

阿罗哈

我在我的 .NET 2.0 应用程序中引用了一个外部 Web 服务。添加服务引用为我生成了一个不错的代理类。我想为此添加///<summary>样式文档。如果更新了服务参考，我所有闪亮的评论都消失了。

有什么解决办法吗？

Answer 1

您可以围绕生成的代理类创建一个包装类，并在那里记录方法。然后，您总是使用包装类，而不是直接使用生成的代理。例如：

public class MyWebServiceWrapper
{
  private MyWebService _service = null;

  public MyWebServiceWrapper()
  {
    _service = new MyWebService();
  }

  ///<summary>
  /// doc goes here
  ///<summary>
  public int MethodOne()
  {
    return _service.MethodOne();
  }
}

这种方法允许您在需要时重新生成代理类。

当然这意味着，每当 Web 服务的接口发生变化时，您都必须（手动）更新包装类。另一方面，包装类还允许您添加一些集中的错误处理等。