日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當前位置: 首頁 > 编程资源 > 编程问答 >内容正文

编程问答

我的注释那去了?

發布時間:2023/12/4 编程问答 23 豆豆
生活随笔 收集整理的這篇文章主要介紹了 我的注释那去了? 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

當我們用nuget引用三方庫時,在類型,或類型成員上會有注釋,如下圖,是MySql官方包,command的ExecuteNonQuery的注釋

我們自己寫一個類庫項目CommentsLibrary,給類,構造函數,方法添加xml注釋,然后生成

using System;namespace CommentsLibrary {/// <summary>/// Test類注釋/// </summary>public class TestClass{/// <summary>/// Test類注釋 構造/// </summary>public TestClass(){}/// <summary>/// 方法注釋/// </summary>/// <param name="param">注釋參數</param>/// <returns>注釋返回值</returns>public string TestMethod(string param){return $"{param}:{DateTime.Now}";}} }

然后在我們的CommentsApp項目中引用CommentsLibrary.dll(不是在同一個解決方案中引用項目,因為我們是把dll給別人用,不是把源碼給別人用),你會發現是沒有注釋的,我的注釋哪去了呢?

那繼續回到MySqlCommand,看一下他為什么會有注釋,選中CommentsApp項目,依賴項中的包,找到MySql.Data

進入nuget包所在的路徑

在lib下,有不同的適配框架,你會發現,不管那個框架,除了dll外還有xml文件,打開xml,你會發現,原來注釋藏在這里,也就是說,我們只引用dll時,是沒有注釋的,注釋是單獨放在xml中的。

其實為項目添加xml也很簡單,接下來為CommentsLibrary項目添加xml,注釋會自動生成到xml文件中

這里,我們重新引用CommentsLibrary.dll,查看TestMethod,就會有注釋了(有時有緩存,可能會看不到或刪除xml還能看到注釋)

所以,我們最好用nuget來管理我們的包,如果是私有庫,就搭建私有nuget服務(還記得我把標題寫錯的那篇文章嗎?輕量NuGet服務—GaGet),這樣即能有版本區分,也能自然把注釋xml引入進來。否則,就把xml文件帶上

總結

以上是生活随笔為你收集整理的我的注释那去了?的全部內容,希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯,歡迎將生活随笔推薦給好友。