一、問題描述
在下面的截圖中,我們發現,源碼有添加一段注釋。
然后通過Nuget包引用,在VS中用Reshaper反編譯時,發現沒有注釋:
原來,DLL是默認不帶注釋的。即你生成一個DLL,給另一個項目引用,使用時看不到原有的注釋。
二、解決方案
那如何將原有注釋顯示出來?可以在項目屬性-生成-輸出菜單下,勾選“XML 文檔文件”選項。
勾選后,在項目的文件列表中會自動生成xml文件:
重新打Nuget包並引用時,你也會發現,在nuget的lib文件夾下,多了份xml文件:
這樣,使用DLL/Nuget包時,就有注釋顯示了。
另外 ,添加xml注釋輸出后,會提示開發人員補充代碼注釋:
三、其它問題
如果引用的Nuget包,還是沒有注釋。可以看下是否.NET版本原因,要把輸出的TargetFramework都要加上xml才行