星空网 > 软件开发 > ASP.net

VS中如何快捷地给自己的代码添加创建信息注释

VS中如何快捷地给自己的代码添加创建信息注释

Intro

以下讨论的都是没有使用 GIT 来管理源代码的情况,如果使用 GIT 管理源代码可直接使用VS的Git扩展就不需要考虑以下问题。

  1. 什么是创建信息注释?

    创建信息注释,类似于文件的创建信息,一般来说,至少要有创建人和创建时间。如果说有人修改了方法也应该添加一个更新信息注释。

  2. 为什么要添加创建信息注释?

    可能在一个人编码的时候,创建信息注释并不太重要,但是如果许多人共同维护一个项目,并且经常会出现多个人修改同一个文件的代码 时,这就显得很重要了,哪里的代码出现了什么问题,可以直接责任到人,谁改的代码出现了问题就应该谁去修改代码。

创建信息注释

  1. 找解决方案 最初的想法是重写 VS 内置的文档注释,然而并没有找到这样的解决方案。找到的基本都是修改新建类或接口时模板文件从而添加注释,并没有在方法上加注释 的解决方案。

    这个方案否定之后,尝试着使用自定义代码段来实现在生成注释的基础上再添加创建信息注释。

  2. 自定义代码段

    自定义代码段参考示例:

     1     <??> 2     <CodeSnippets ="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet"> 3       <CodeSnippet Format="1.0.0"> 4         <Header> 5           <Title>cm</Title> 6           <Shortcut>cm</Shortcut> 7           <Description>新建代码注释 的代码片段</Description> 8           <Author>liweihan</Author> 9           <SnippetTypes>10             <SnippetType>Expansion</SnippetType>11           </SnippetTypes>12         </Header>13         <Snippet>14           <Declarations>15             <Literal>16               <ID>Description</ID>17               <ToolTip>方法描述</ToolTip>18               <Default>方法描述</Default>19             </Literal>20             <Literal>21               <ID>Author</ID>22               <ToolTip>作者</ToolTip>23               <Default>liweihan</Default>24             </Literal>25             <Literal>26               <ID>CreateDate</ID>27               <ToolTip>日期</ToolTip>28               <Default>@@Today</Default>29             </Literal>30           </Declarations>31           <Code Language="csharp">32           <![CDATA[/// <summary>33           /// $Description$34           /// @Author:$Author$35           /// @CreateDate:$CreateDate$$end$36           /// </summary>]]>37           </Code>38         </Snippet>39       </CodeSnippet>40     </CodeSnippets>

     

     

     这样的代码段还有许多不足,现在作者是写死的,创建时间需要再插入代码段之后再进行手动修改, 我希望能够自动生成作者和当前日期, 作者写死的问题不大,因为这个代码段只我一个人使用,直接写死反而更方便,这里使用一个变量方便进行修改, 关键是当前日期没有办法获取到,查阅了很多资料,代码段并不支持直接插入当前日期,stackoverflow 上有人讨论过这个问题,解决方案是利用宏自动生成当前日期,但是文中提到的解决方案不可用,不过倒给了我解决问题的思路——利用宏去插入当前日期。

  3. 宏插入当前日期 我在 VS 的 扩展与更新 中下载了一个 管理宏的插件—— Macros for Visual studio

    VS中如何快捷地给自己的代码添加创建信息注释

     

    下载安装之后需要重启 VS ,重启之后在 菜单栏中的工具下就可以看到:

    VS中如何快捷地给自己的代码添加创建信息注释

     

    这个宏管理器自带了一些 Samples ,其中有一个可以插入日期的宏

    VS中如何快捷地给自己的代码添加创建信息注释

     

    选择 Assign Shortcut 进行设置快捷键就可以在 VS 中使用啦,默认的格式是 “mm/dd/yyyy”

    VS中如何快捷地给自己的代码添加创建信息注释

     

    如果你像我一样不喜欢默认的日期格式,可以在对应项上右键选择“打开”,进行编辑,里面是 js 代码,有一些 js 基础的话修改起来会 更方便,我修改了下代码,将日期格式修改为了“yyyy-MM-dd”格式。

    VS中如何快捷地给自己的代码添加创建信息注释

     

  4. 完整操作流程

    • 首先,在方法体上输入“///”,VS 会自动生成默认的文档注释,先写好注释
    • 复制<summary>部分的注释,选中 <summary> 部分,参数及返回信息保留,输入定义好的代码段快捷键,双击 Tab 键插入代码段
    • 将复制的注释粘贴到 方法描述 处,添加注释
    • Tab 键切换到 当前日期,在 @@Today 处,按设置的插入当前日期的宏快捷键,VS 会自动插入当前日期

更新信息注释

更新信息代码段示例:

 1   <??> 2   <CodeSnippets ="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet"> 3     <CodeSnippet Format="1.0.0"> 4       <Header> 5         <Title>up</Title> 6         <Shortcut>up</Shortcut> 7         <Description>更新代码注释 的代码片段</Description> 8         <Author>liweihan</Author> 9         <SnippetTypes>10           <SnippetType>Expansion</SnippetType>11         </SnippetTypes>12       </Header>13       <Snippet>14         <Declarations>15           <Literal>16             <ID>Description</ID>17             <ToolTip>更新描述</ToolTip>18             <Default>更新描述</Default>19           </Literal>20           <Literal>21             <ID>UpdatedBy</ID>22             <ToolTip>更新人</ToolTip>23             <Default>liweihan</Default>24           </Literal>25           <Literal>26             <ID>UpdatedDate</ID>27             <ToolTip>日期</ToolTip>28             <Default>@@Today</Default>29           </Literal>30         </Declarations>31         <Code Language="csharp">32         <![CDATA[/// $Description$ @UpdatedBy:$UpdatedBy$ @UpdatedDate:$UpdatedDate$$end$ ]]>33         </Code>34       </Snippet>35     </CodeSnippet>36   </CodeSnippets>

 

 

 

将自定义代码段添加到 VS

  • VS 中打开代码段管理器

VS中如何快捷地给自己的代码添加创建信息注释

 

VS中如何快捷地给自己的代码添加创建信息注释

 

  • 选择语言为 “CSharp”,选中“My Code Snippets”,复制位置中的路径,并在资源管理器中打开路径
  • 将自定义的代码段(*.snippet)拷贝到上一步打开的目录中,重启VS就可以了



原标题:VS中如何快捷地给自己的代码添加创建信息注释

关键词:

*特别声明:以上内容来自于网络收集,著作权属原作者所有,如有侵权,请联系我们: admin#shaoqun.com (#换成@)。

Lazada前CEO募了1.5亿美元专收亚马逊卖家:https://www.ikjzd.com/articles/142128
订单做不完,薪资开口就要2万,工厂被逼疯了:https://www.ikjzd.com/articles/142129
DHL快递发布2021年春节假期服务安排调整通知:https://www.ikjzd.com/articles/142130
实锤!顺丰175亿港元收购嘉里物流51.8%股权:https://www.ikjzd.com/articles/142131
亚马逊产品视频制作与关联视频设置技巧分享:https://www.ikjzd.com/articles/142132
eBay引流技巧:https://www.ikjzd.com/articles/142133
独家丨B站广告位可跳转美团APP B站为电商平台引流再升级 :https://www.kjdsnews.com/a/1836410.html
百崖大峡谷生态旅游景区(探秘中国西南自然风光):https://www.vstour.cn/a/363176.html
相关文章
我的浏览记录
最新相关资讯
海外公司注册 | 跨境电商服务平台 | 深圳旅行社 | 东南亚物流