C# Документация <include> не найден

Question

Привет, У меня есть небольшая проблема, я не понимаю.

Я хочу документировать свой код, используя комментарии к документации. И у меня есть XML-файл с Infromation об авторе, который написал часть кода.

Я использую VisualStudio 2013 и имеют в проекте diractory имени Документация есть Author.xml Файл с этой структурой:

<doc> 
    <member name="number1"> 
    <remarks>some Information</remarks> 
    </member> 
    <member name="number2"> 
    <remarks>some Information</remarks> 
    </member> 
    ... 
</doc> 

в моем коде у меня есть этот комментарий

/// <summary> 
/// 
/// </summary> 
/// <include file='~/Documentation/Author.xml'path='doc/member[@name="number1"]/*'/> 
public class ExampleClass { ... } 

но в documentation.xml генерируется:

<summary> 
</summary> 
<!-- Der enthaltene XML-Abschnitt konnte nur teilweise oder gar nicht eingefügt werden. --><include file="~/Documentation/Author.xml" path="doc/member[@name=&quot;number1&quot;]/*"/> 

что Меенс в XML-коде может не включается У меня это из книги о C# для новичков, но это не работает.

Пожалуйста, помогите мне с моей проблемой.

Answer 1

<include file='~/Documentation/Author.xml'path='doc/member[@name="number1"]/*'/ 

Я вижу две проблемы с этим:

1. ~ не имеет особого смысла в путях Windows: вы бы лучше, используя путь относительно проекта.

2. Вам нужно указать промежуток между одним атрибутом и другим: изменить …xml'path=… на …xml' path=….