Документа метод-резюме с ambigious ссылкой

Question

У меня есть массово перегруженный метод MethodA который ссылается сводным теге в моей документации по MethodB:

/// <summary>A link to <see cref="MethodA" /></summary> 
void MethodB { ... } 

Комментарий должен не только полагаться на специальную перегрузку MethodA но и всем им. Однако компилятор печатает сообщения о том, что атрибут cref является неоднозначным (что, однако, предназначено). Есть ли какая-либо передовая практика для решения этой проблемы? Я уже думал о том, чтобы полностью удалить see -tag из summary. Может быть, у вас есть другие подходы?

Answer 1

Я думаю, у вас есть 2 варианта. Либо обратиться к определенному методу в комментарии:

/// <summary>A link to <see cref="MethodA(int)" /> or one of it's overloaded variants</summary> 

В качестве альтернативы, вы можете добавить M: prefix, который удалит ошибку, хотя может быть не совсем то, что вам требуется:

/// <summary>A link to <see cref="M:MethodA" /></summary>