Подавляет ли тег комментария ‹include› intellisense?

Я обдумывал идею использования ‹ include > Visual Studio. для хранения части или всей моей документации по коду отдельно от его источника, но когда я попытался создать тестовый XML-файл и указал на него с помощью включения для некоторых из моих методов, я обнаружил, что intellisense не работает для этих методов.

Предполагается ли, что тег include для комментариев xml поддерживает intellisense, или он не поддерживается (по соображениям практичности, как я полагаю)? Если поддерживается, то что я могу делать не так? Я почти уверен, что мой XPath сформирован правильно, поскольку StyleCop не жаловался на это.

Я использую VS2008 и недавно установил Resharper, StyleCop и StyleCop для Resharper.


person Sean    schedule 06.02.2010    source источник
comment
Вы скомпилировали с: /doc:DocFileName.xml ?   -  person Cory Charlton    schedule 07.02.2010
comment
Согласно документации, эта опция задает выходной файл для автоматически сгенерированного файла, который отражает всю XML-документацию (включая содержимое непосредственно в исходном файле). Он используется для таких вещей, как Sandcastle, для создания файлов справки. Тег include предназначен для импорта указанного пользователем файла, который также включается в выходной файл, указанный этим тегом. Мне нужно знать, есть ли способ сделать так, чтобы эта информация также отображалась в intellisense.   -  person Sean    schedule 07.02.2010


Ответы (1)


К сожалению, он не поддерживается ни в V2008, ни в VS2010 :(

Я не уверен в конкретной причине, но, скорее всего, потому, что было недостаточно запросов на его реализацию от клиентов как внутри Microsoft, так и за ее пределами.

Однако мы могли бы рассмотреть возможность реализации его в VS.next. Будет полезно, если вы зарегистрируете это как ошибку в Microsoft Connect (http://connect.microsoft.com/VisualStudio) — тогда (при условии, что на эту функцию есть реальный спрос) люди будут голосовать за нее, создавая давление на Microsoft с целью ее реализации.

person Oleg Tkachenko    schedule 25.02.2010
comment
Ладно, я боялся, что так и будет, но хорошо знать наверняка. Спасибо! - person Sean; 25.02.2010