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 サービスのインターフェースが変更されるたびに、(手動で) ラッパー クラスを更新する必要があることを意味します。一方、ラッパー クラスを使用すると、一元化されたエラー処理などを追加することもできます。