С#, XmlDoc: как ссылаться на перегрузки метода
Если у меня есть эти два метода
public Foo Get(string bar) { ... }
public Foo Get(int bar) { ... }
И напишите этот фрагмент документации xml по другому методу
/// <summary>
/// Has a close relation to the <see cref="Get"/> methods.
/// </summary>
Я получаю синий squiggly под Get
, говоря, что это неоднозначная ссылка "Get". это правда, но я хочу, чтобы он ссылался на оба. Каков правильный способ сделать это? Или я должен только ссылаться на один метод перегрузки?
Ответы
Ответ 1
Try
/// Has a close relation to the <see cref="Get(string)"/>
/// and <see cref="Get(int)" /> methods.
Вам могут потребоваться полные имена, но intellisense должен помочь, как только вы положите первую скобку.
Надеюсь, что это поможет,
Dan
Ответ 2
Вот обновленный ответ на этот старый вопрос. Я не уверен, когда это стало действительным, потому что там не так много документации. Если вы префикс атрибута cref
с "o:..."
, например, в "o:myMethod()"
, он будет ссылаться на раздел перегрузки и покрывать все перегрузки этого метода. Используя пример ответа Даниэля Эллиотта:
/// Has a close relation to the <see cref="o:Get()"/> methods.
Это также устранит предупреждения Intellisense/Resharper о неоднозначных ссылках.