Как могут XML-комментарии .NET к исходному коду сохраняться в метаданных сборки?

Question

Заметили ли вы, что для некоторых методов в системных сборках .NET Reflector также показывает соответствующую документацию?Это означает, что документация может быть сохранена в метаданных сборки.

Как я могу заставить это работать для моих собственных сборок?Это означает, что я хочу видеть свои комментарии к моему методу, когда я отражу его в .NET Reflector.

Спасибо.

Answer 1

Комментарии XML doc не сохраняются в метаданных сборки.Фактически, Visual Studio и другие инструменты, такие как Reflector, находят комментарии XML doc путем поиска по набору хорошо известных путей, содержащих файлы комментариев XML doc.

Если вы хотите просмотреть XML-документацию для своих собственных сборок, убедитесь, что XML-файл находится в том же каталоге, что и сборка, на которую делается ссылка, и имеет то же имя, что и ваша сборка (за вычетом расширения).Например, MyAssembly.Namespace.XML соответствует MyAssembly.Namespace.dll сборка.

Видишь Как просмотреть XML-комментарии к коду из Reflector для получения дополнительной информации.