Комментарии XML для свойств переопределения - PullRequest
Новая
       14

Комментарии XML для свойств переопределения

8 голосов
/ 09 ноября 2011

Я использую MonoDevelop 2.4.2 для OS X (версия, которая поставляется с Unity 3.4.1), и мне было интересно, есть ли какой-нибудь способ унаследовать комментарии от базового класса или свойства.

Пример: 

public class Foo
{
    /// <summary>
    /// The describes the ABC property
    /// </summary>
    public virtual int ABC
    {
        get { return _abc; }
        set { _abc = value; }
    }
    protected int _abc;

    /// <summary>
    /// The describes the XYZ property
    /// </summary>
    public virtual int XYZ
    {
        get { return _xyz; }
        set { _xyz = value; }
    }
    protected int _xyz;
}

public class Bar : Foo
{
    public override int ABC
    {
        set
        {
            // DO SOMETHING
            base.ABC = value;
        }
    }
}

Bar bar = new Bar();

// In MonoDevelop 2.4.2 (OS X), the ABC property doesn't show the comments
// in the autocomplete popup or when you hover the mouse over the property.
int abc = bar.ABC;

// ... but they do show up for XYZ, because it doesn't override
int xyz = bar.XYZ;

Этот вопрос кажется чем-то похожим на Наследование комментариев для C # (фактически любого языка) , хотя меня больше всего интересует, как они ведут себя в редакторе на данном этапе, иэто относится только к MonoDevelop.

Некоторые решения в этом вопросе упоминаются, который, по-видимому, недопустим в MonoDevelop (или я его неправильно использую), а Ghostdoc предназначен для Visual Studio.

Кажется, что единственным решением было бы дублировать комментарии свойств в унаследованном классе,Есть ли альтернативы?

1 Ответ

1 голос
/ 14 ноября 2011

Я не могу это подтвердить, но раньше был надстройка DocFood, которая теперь является частью MonoDevelop (последняя версия 2.8. * Я думаю). Попробуйте, я думаю, что он может наследовать комментарии от родительской реализации.

...