吉林沈阳网站建设,seo实战密码电子书,企业网站建设设置那些栏目,相城网站建设当我们用nuget引用三方库时#xff0c;在类型#xff0c;或类型成员上会有注释#xff0c;如下图#xff0c;是MySql官方包#xff0c;command的ExecuteNonQuery的注释我们自己写一个类库项目CommentsLibrary#xff0c;给类#xff0c;构造函数#xff0c;方法添加xml… 当我们用nuget引用三方库时在类型或类型成员上会有注释如下图是MySql官方包command的ExecuteNonQuery的注释我们自己写一个类库项目CommentsLibrary给类构造函数方法添加xml注释然后生成using System;namespace CommentsLibrary
{/// summary/// Test类注释/// /summarypublic class TestClass{/// summary/// Test类注释 构造/// /summarypublic TestClass(){}/// summary/// 方法注释/// /summary/// param nameparam注释参数/param/// returns注释返回值/returnspublic 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文件带上
