我的注释那去了?

当我们用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文件带上

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/302479.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

[原] jQuery EasyUI 1.2.6源码、Demo合集、离线API

下载地址&#xff1a; http://files.cnblogs.com/purediy/jquery-easyui-1.2.6.zip 兄弟版本&#xff1a; jQuery EasyUI 1.3.4 离线API、Demo jQuery EasyUI 1.3.2 离线API、Demo jQuery EasyUI 1.3.0 Demo合集、离线API、动态换肤 相信关注过jQuery UI 的大部分都查到过easyu…

ubuntu14安装python_ubuntu14.04 安装python3.7

下载源码&#xff1a;https://www.python.org/downloads/release/python-373/一、先安装需要的包zlib1g,libffisudo apt-get updatesudo apt-get install zlib1g-devsudo apt-get install libffi-dev二、在ubuntu上创建/usr/local/python3.7的目录&#xff0c;将压缩包放到该目…

CCNA第二章

第二章 交换机的基本概念和配置&#xff1a; Ethernet/802.3网络的关键要素&#xff1a; 载波侦听多路访问/冲突检测&#xff08;CSMA/CD&#xff09; CSMA/CD 仅用于集线器中常用的半双工通信。全双工交换机不使用 CSMA/CD。载波侦听&#xff1a;在 CSMA/CD 接入方法中&#x…

看书的一点小建议!

阅读本文大概需要6分钟。昨天看见小北写了一篇&#xff1a;「看书的一点小建议」&#xff0c;写的很不错&#xff0c;今天也分享一下自己看书的心得。其实不少读者问过我怎么看计算机经典大厚书、怎么看产品运营经典大厚书、怎么提高看书效率&#xff1a;电影教父里有台词&…

技巧:Excel用得好,天天没烦恼

全世界有3.14 % 的人已经关注了数据与算法之美Excel是Office三大神器当中最神秘、但也是最能提高你效率的工具了。而我们中的太多小伙伴&#xff0c;却一直把它当做是个“电子表格工具”。今天一起涨姿势&#xff0c;学会下面这些神技&#xff0c;你的Excel分分钟超过90%的同事…

操作数数据类型 char 对于 sum 运算符无效。_数据类型和运算符

数据类型和运算符1.进制1.1文件存储单位​ 任何数据在计算机中都是以二进制的形式存在的&#xff0c;二进制早期由电信号开关演变而来 。​ 一个电信号或者一个二进制位统称为Bit位&#xff0c;8个Bit位为一组组成一个字节Byte 。​ 一个bit位表示的数的范围&#xff1a;0和1​…

PHP excel文件导入至mysql中!

今天的项目需要一个导入excel文件到mysql的功能&#xff01;折腾了很久&#xff0c;去网上也找到一大堆的帖子&#xff01; 实现方式有几种: 1、使用扩展类库对excel文件进行操作&#xff01;如&#xff1a;PHPExcel类包、phpexcelreader类文件&#xff08;比较小巧&#xf…

我所理解的开源软件供应链安全

点击上方“开源社”关注我们| 作者&#xff1a;庄表伟| 编辑&#xff1a;钱英宇| 设计&#xff1a;谭嘉露| 责编&#xff1a;王玥敏1供应链与断供隐喻会帮助人&#xff0c;也会误导人。当我们谈到“供应链”时&#xff0c;会产生哪些联想&#xff1f;环环相扣&#xff1f;缺一不…

82 个代码案例实践,带你学好 Python 机器学习

全世界有3.14 % 的人已经关注了数据与算法之美如果村里通了网&#xff0c;那你一定知道【AI】人工智能。如果你会网上冲浪&#xff0c;那你一定看到过【ML】机器学习。小编在网上看到一个段子&#xff1a;ML派坐落美利坚合众山中&#xff0c;百年来武学奇才辈出&#xff0c;隐然…

Python进阶08 异常处理

作者&#xff1a;Vamei 出处&#xff1a;http://www.cnblogs.com/vamei 欢迎转载&#xff0c;也请保留这段声明。谢谢&#xff01; 本文特别感谢kylinfish的纠正&#xff0c;相关讨论见留言区。 异常处理 在项目开发中&#xff0c;异常处理是不可或缺的。异常处理帮助人们debug…

查询程序崩溃日志_PC 崩溃报告途径 amp; 临时解决方法

TC Sera (社区经理)&#xff1a;你好&#xff01;如果您在电脑游戏中遇到与 Nvidia 驱动程序相关的崩溃情况&#xff0c;请打开视频设置(Video Settings)中的诊断模式(Diagnostics Mode)并重新启动游戏。如果您遇到问题&#xff0c;请打包&#xff1a;%localappdata%\Gears5\Sa…

C# ConcurrentBag的实现原理

一、前言笔者最近在做一个项目&#xff0c;项目中为了提升吞吐量&#xff0c;使用了消息队列&#xff0c;中间实现了生产消费模式&#xff0c;在生产消费者模式中需要有一个集合&#xff0c;来存储生产者所生产的物品&#xff0c;笔者使用了最常见的List<T>集合类型。由于…

Linux里10个最危险的命令

全世界只有3.14 % 的人关注了数据与算法之美Linux命令行佷有用、很高效&#xff0c;也很有趣&#xff0c;但有时候也很危险&#xff0c;尤其是在你不确定你自己在正在做什么时候。推荐阅读Linux之父林纳斯自传《只是为了好玩》这篇文章将会向你介绍十条命令&#xff0c;但你最好…

arcgis xml 下载 切片_GIS开发:Arcgis的切片格式

常规的地图切片&#xff0c;存储在计算机的目录&#xff0c;一般都是以数字的模式&#xff0c;表现层级的文件夹名称&#xff0c;无外乎缩放等级(level)&#xff0c;横向的切片数(x),纵向的切片数(y)&#xff0c;例如下边的一个切片存放文件夹&#xff0c;按照level\y\x.jpg进行…

管理Apache服务器访问日志

管理Apache服务器访问日志 1&#xff0e;相关配置文件说明 一个优秀的Linux网络管理员会密切关注服务器日志系统&#xff0c;这些日志可以提供异常访问的线索。Apache可以记录所有的访问请求&#xff0c;同样&#xff0c;错误的请求也会记录。Apache配置文件中&#xff0c;需要…

《.NET内存管理宝典》在京东上架销售啦!

为什么要阅读本书正如本书第14章14.3节所提到的&#xff0c;如下类型的应用程序十分需要本书的知识。● 金融软件&#xff1a;特别是实时交易和所有需要基于大量各种数据以尽快得出答案的分析决策。● 大数据&#xff1a;虽然大数据通常都是批量、慢速处理&#xff0c;…

让你立刻爱上数学的10个算术游戏

全世界只有3.14 % 的人关注了数据与算法之美死理性派的小编经常会被问到的一个问题&#xff1a;数学到底哪里有趣了&#xff0c;数学之美又在哪里&#xff1f;这篇文章精心选择了 10 个老少咸宜的算术问题&#xff0c;以定理、趣题甚至未解之谜等各种形式带领大家窥探数学世界的…

python json方法详解_python详解json模块

我们在做工作中经常会使用到json模块&#xff0c;今天就简单介绍下json模块什么是jsonJSON &#xff0c;全称为JavaScript Object Notation&#xff0c; 也就是JavaScript 对象标记&#xff0c;它通过对象和数组的组合米表示数据&#xff0c;构造简洁但是结构化程度非常高&…

iPhone 的 Push(推送通知)功能原理浅析

第一部分&#xff1a;Push原理(以下绝大多数内容参考自、图片来自iPhone OS Reference Library)机制简介Push 的工作机制可以简单的概括为下图图中&#xff0c;Provider是指某个iPhone软件的Push服务器。 APNS 是Apple Push Notification Service&#xff08;Apple Push服务器&…

关于C#异步编程的建议

基于任务的异步编程模型 (TAP) 提供了异步代码的抽象化。你只需像往常一样将代码编写为一连串语句即可。就如每条语句在下一句开始之前完成一样&#xff0c;你可以流畅地阅读代码。编译器将执行许多转换&#xff0c;因为其中一些语句可能会开始运行并返回表示正在进行的工作的 …