3

皆さんこんにちは、私の質問はとても簡単です。

/// <summary>
/// a description here. for internal use
/// </summary>
private A _Owner;
/// <summary>
/// Same description also here. for outside use
/// </summary>
public A Owner
{
    get { return _Owner; }
    set { _Owner = value; }
}

同じコメントを2回書かないようにする方法はありますか? それはただの迷惑です。

4

5 に答える 5

7

まず、フィールドを含むプライベート メンバーにはインテリセンス コメントは必要ないことに注意してください。したがって、最初のコメントを削除するだけです。フィールドの意味が名前から明らかでない場合は、適切な名前が付けられていません。

第二に、ほとんどの単純なプロパティでは、明示的なフィールド宣言を完全に削除できます...

/// <summary>a description here</summary>
public A Owner {get;set;}
于 2013-02-07T11:51:46.083 に答える
5

そうではありません。ただし、プライベート メンバーはクラスの外には表示されないため、プロパティにコメントするだけで十分です。だからあなたの財産にコメントしてください。

于 2013-02-07T11:52:20.583 に答える
4

それがバッキング フィールドへの単純なビューである場合は、重複を避けるために auto プロパティを使用してください。

/// <summary>
/// just use an autoprop
/// </summary>
public A Owner
{
    get;set;
}
于 2013-02-07T11:51:01.047 に答える
2

自動実装プロパティを使用すると、プロパティに 1 つの XML コメントを指定できます。

/// <summary>
/// Same description also here. for outside use
/// </summary>
public A Owner
{
get; set;
}

しかし、get または set でプライベート フィールドを使用して何かを行う場合は、XML コメントを 2 回指定する必要があります。

もう 1 つ、プロパティだけに XML コメントを指定する必要があります。これは、 public フィールドではなく、クラスの外部に公開されるためです。

于 2013-02-07T11:52:13.383 に答える
1

いいえ、これを回避する方法はありません。インテリセンスは、書かれたコメントを見つかったコード アーティファクトにリンクします。あなたの場合、それらのうちの2つがあります：

  • 1つはpropertyです。
  • もう一つはfield.

したがって、あなたの場合、それを 2 回記述するか、spender が提案したように、auto プロパティを使用して 1 回定義する必要があります。

于 2013-02-07T11:53:22.657 に答える