Как использовать <include>во внешнем файле comments.xml для ссылки на другого участника. .Сеть - PullRequest
1 голос
/ 22 августа 2011

Я знаю, как использовать ключевое слово из моего кода для ссылки на участника во внешнем файле комментариев.Что-то вроде:

<include file="Comments.xml" path="Docs/ClassName/Members[@name='DoIt']/*" />

Однако у меня есть члены в файле Comments.xml, которые повторяются, и я хотел бы выделить их и обратиться к самому файлу Comments.xml.Например, это может быть определение аргумента, которое используется несколько раз.

Я пробовал тот же формат, что и выше, но он не работает.Есть идеи?

ETA: Согласно этому посту в блоге , «Причина 3», он должен работать с точно таким же синтаксисом, поэтому я не уверен, почему он не работает для меня,Если я посмотрю на XML-файл, который генерирует visual studio, то ошибки не было.На самом деле это не похоже на то, что он даже пытался включить элемент, поскольку моя первоначальная строка include все еще там (но с частью 'path', появляющейся перед частью 'file').

ETA2Я должен был исправить пример c # в вышеупомянутом сообщении в блоге, чтобы разделить include-include на отдельный xml-файл, в противном случае при компиляции был сгенерирован stockoverflow.
Однако я не могу заставить его работать на меня.Я использую VB, и я протестировал его в 2008 и 2010 годах - оба экспресс-издания.Это означает, что либо синтаксис отличается, либо функциональность не реализована в версиях Visual Studio VB.

1 Ответ

0 голосов
/ 05 декабря 2011

Выглядит так, как будто вы хотите, чтобы в вашем XML-файле был элемент, который включен в документацию для всех ваших членов класса?Я делал это раньше, но я не думаю, что у меня есть элемент, работающий в файле XML.Мое решение состояло в том, чтобы в моем коде c # было несколько элементов.

Например:

/// <include file="Comments.xml" path="Docs/ClassName/AllMembers/*" />
/// <include file="Comments.xml" path="Docs/ClassName/Members[@name='DoIt']/*" />
...