Используйте /// <inheritdoc/>
, если Вы хотите наследование. Избегайте GhostDoc или чего-либо как этот.
я соглашаюсь, что это является раздражающим, который не наследованы комментарии. Это было бы довольно простое дополнение, чтобы создать, если бы у кого-то было время (мне жаль, что я не сделал).
Однако в нашей кодовой базе мы помещаем XML-комментарии на интерфейсы только и добавляем дополнительные комментарии реализации к классу. Это работает на нас, поскольку наши классы являются частными/внутренними, и только интерфейс общедоступен. Любое время мы используем объекты через интерфейсы, у нас есть полный дисплей комментариев в intellisence.
GhostDoc является хорошим началом и сделал процесс легче записать комментарии. Это - особенно полезные комментарии хранения, актуальные, когда Вы добавите/удалите параметры, повторно выполняете GhostDoc, и это обновит описание.
Да, я наконец-то разобрался с этим:
public IQuerable<T> CreateLinqQuery()
{
var query = session.Linq<T>();
query.QueryOptions.SetCachable(true);
return query;
}
Обновление Как указывали другие, в NH3 используйте query.Cacheable (). Однако будьте очень осторожны, делая это вот так:
// Correct way:
query = query.Cacheable();
// This won't work:
query.Cacheable();