VS2010: автоматически сгенерированный файл документации XML не обновляется - PullRequest
Новая
       33

VS2010: автоматически сгенерированный файл документации XML не обновляется

8 голосов
/ 12 мая 2011

У меня есть проект C # в vs2010, который генерирует файл документации XML, в котором я установил путь вывода сгенерированного файла равным пути вывода проекта.

Моя проблема заключается в том, что файл не обновляется, когдапуть к файлу документа совпадает с выходным путем проекта, а имена файлов совпадают (кроме расширений файлов).

Не не обновить файл XML:

  • C: \ MyProjectFolder \ MyProject.dll
  • C: \ MyProjectFolder \ MyProject.xml (файл документации)

Но когда я меняю либо другую папку, либоизмените имя файла документации, файл генерируется правильно.

Обновляет ли файл XML:

  • C: \ MyProjectFolder \ MyProject.dll
  • C: \ AnotherFolder \ MyProject.xml

также обновляет XML-файл

  • C: \ MyProjectFolder \ MyProject.dll
  • C: \MyProjectFolder \ AnotherFileName.xml

или более правильно;когда путь и имя файла такие же, как в первом примере, файл является регенерированным, но со старой информацией и старой измененной отметкой времени.

Он работал раньше в VS 2008, иЯ не хочу менять имя файла или путь, потому что другие зависят от него.

Есть предложения, что может быть не так?Может ли это быть временный файл, который копируется?Может быть, какой-то кэш мог быть очищен в папке VS 2010?

ДОПОЛНИТЕЛЬНАЯ ИНФОРМАЦИЯ: Я заметил, что если исходный файл XML-документации удаляется, а затем в свойствах проекта указывается новое имя, генерируется новая XML-документацияи является правильным и актуальным, но старый файл XML со старым именем также воссоздается - все еще в своем предыдущем состоянии.Это должно быть где-то в кеше ...

Ответы [ 2 ]

1 голос
/ 16 мая 2011

Я использую VS 2010, и моя документация XML обновляется правильно при каждой сборке.

Даже простая перестройка заставит файл обновиться. Если вы измените описание класса и перестроите его, вы также должны получить XML с обновленным описанием.

0 голосов
/ 12 мая 2017

Я также столкнулся с этой проблемой в Visual Studio 2015 Update 3.

Я включил Diagnostic Детализация сборки проекта MSBuild в Инструменты> Параметры Visual Studio и обнаружил, что он копирует версию файла документации XMLиз выходного каталога другого проекта.

Только после того, как я сделал Clean для всех конфигураций сборки решения и затем пересобрал свой проект, файл документации XML был восстановлен и отразил последние комментарии XML в моем коде.

...