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

时间:2009-01-15 10:53:09

标签: web-services proxy comments service-reference

阿罗哈

我在.NET 2.0应用程序中引用了外部Web服务。添加服务引用为我生成了一个很好的代理类。我想在此添加///<summary>样式文档。如果更新了服务引用,那么我的所有闪亮注释都将消失。

有没有解决方案?

1 个答案:

答案 0 :(得分:1)

您可以围绕生成的代理类创建包装类,并在那里记录方法。然后,您不必直接使用生成的代理,而是始终使用您的包装类。 E.g:

public class MyWebServiceWrapper
{
  private MyWebService _service = null;

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

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

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

当然,这意味着,只要Web服务的接口发生更改,您就必须(手动)更新包装器类。另一方面,包装器类还允许您添加一些集中的错误处理等。