如何在Intellisense工具提示中使用<include>標記顯示包含的Xml文檔中的內容

Question

我試圖清理包含相當數量代碼的類。我也想記錄和文件。不幸的是，對我來說，所有這一切都在一個文件中造成眼睛的混亂。這是嚴重的，爲了快速發展，它創造了大量不必要的醒目文字來梳理。

<include>似乎有希望實現這一目標，同時保持智能感知功能。即包含的Xml文檔摘要將顯示在工具提示中，就像Xml文檔在方法上方聲明一樣。

也許我誤解了<include>，但我這樣做了，工具提示沒有包含在其他文件中的Xml文檔。

這裏是我有現在的設置：

/// <include file='xml_include_tag.xml' path='include/member[@name="Foo"]/*' /> 
private String Foo() 
{ 
    return "Foo"; 
} 

XML文件看起來是這樣的：

<include> 

    <member name="Foo"> 
     <summary> 
      Returns "Foo" 
     </summary> 
     <returns></returns> 
    </member> 

</include> 

我是正確使用本產品或者是這甚至不可能實現與提供工具集？

在此先感謝！

Answer 1

該文檔並不完全清楚，但似乎Visual Studio C＃編輯器中的IntelliSense不支持此功能（至少在VS2013中）。太糟糕了，它似乎很有用。

相反，它似乎只適用於項目屬性（Build部分）中的「XML文檔文件」選項，該選項輸出預期的XML。

請注意，您的XML文件與XPath語句不完全匹配 - 您需要一個名爲<include>的根元素纏繞在​​元素上以便匹配。