Скажем, у меня есть этот конструктор:
/// <summary>
/// Example comment.
/// </summary>
public SftpConnection(string host, string username,
string password, int port) {...}
который имеет эти перегрузки:
public SftpConnection(string host, string username, string password)
: this(host, username, password, 22) { }
public SftpConnection(string host, string username, int port)
: this(host, username, "", port) { }
public SftpConnection(string host, string username)
: this(host, username, "", 22) { }
и на самом деле комментарий XML довольно большой, с элементами param
, example
и exception
и т.д.
Есть ли способ добавить к перегрузкам специальный XML-комментарий с одним слоем, так что они используют одни и те же комментарии, поэтому мне не нужно копировать-вставлять целые огромные оригинальные комментарии?
Я думаю что-то вроде: <use cref="SftpConnection(string,string,string,int)" />
, который не работает, конечно.
Мне известен элемент include
, но я получаю впечатление, что вместо этого он читает комментарии из файла XML, чего я не хочу - я хочу, чтобы комментарий все еще был видимым в коде, но только один раз.
Спасибо: -)