Документация XML: тег <see>с несколькими параметрами универсального типа - PullRequest
3 голосов
/ 09 февраля 2009

Я пытаюсь использовать документацию XML для членов класса, и в некоторых случаях я хотел бы сослаться на универсальный тип, используя тег. Проблема здесь в том, что предупреждение генерируется, когда указано несколько параметров универсального типа. Было достаточно легко найти, как ссылаться на универсальный тип с помощью одного параметра, например:

<see cref="Func{int}" />

Однако попытка чего-то подобного выдает предупреждение:

<see cref="Func{int, bool}" />

Похоже, что я использую неправильный синтаксис для ссылок с более чем одним параметром типа, или такие ссылки в настоящее время не поддерживаются в документах XML для C #. Как ни странно, я не могу найти какую-либо информацию об этом в MSDN или в документации Sandcastle (которую я использую для составления документации, а также жалуется на синтаксис). Любое разъяснение здесь будет оценено.

1 Ответ

9 голосов
/ 09 февраля 2009

Используйте имена .NET, а не псевдонимы C #:

<see cref="Func{Int32, Boolean}" />
...