C＃文檔 <include> 未找到

Question

嗨，我有一個我不明白的小問題。

我想使用文檔注釋來記錄我的代碼。 而且我有一個帶有信息的XML文件，其中涉及編寫代碼部分的作者。

我正在使用VisualStudio 2013，並且在項目中有一個名為Documentation的目錄，其中包含具有以下結構的File 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=…更改為…xml'path=… …xml' path=… 。