您的位置：首页 > 编程语言

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

2016-10-17 15:50 507 查看

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

Intro

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

什么是创建信息注释？

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

为什么要添加创建信息注释？

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

创建信息注释

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

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

自定义代码段

自定义代码段参考示例：

<?xmlversion="1.0"encoding="utf-8"?>
<CodeSnippetsxmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippetFormat="1.0.0">
<Header>
<Title>cm</Title>
<Shortcut>cm</Shortcut>
<Description>新建代码注释的代码片段</Description>
<Author>liweihan</Author>
<SnippetTypes>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>Description</ID>
<ToolTip>方法描述</ToolTip>
<Default>方法描述</Default>
</Literal>
<Literal>
<ID>Author</ID>
<ToolTip>作者</ToolTip>
<Default>liweihan</Default>
</Literal>
<Literal>
<ID>CreateDate</ID>
<ToolTip>日期</ToolTip>
<Default>@@Today</Default>
</Literal>
</Declarations>
<CodeLanguage="csharp">
<![CDATA[///<summary>
///$Description$
///@Author:$Author$
///@CreateDate:$CreateDate$$end$
///</summary>]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>




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

宏插入当前日期我在VS的扩展与更新中下载了一个管理宏的插件——MacrosforVisualstudio



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



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



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



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



完整操作流程

首先，在方法体上输入“///”，VS会自动生成默认的文档注释，先写好注释

复制
<summary>
部分的注释，选中
<summary>
部分，参数及返回信息保留，输入定义好的代码段快捷键，双击Tab键插入代码段

将复制的注释粘贴到
方法描述
处，添加注释

按Tab键切换到当前日期，在
@@Today
处，按设置的插入当前日期的宏快捷键，VS会自动插入当前日期

更新信息注释
更新信息代码段示例：

　　<?xmlversion="1.0"encoding="utf-8"?>
<CodeSnippetsxmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippetFormat="1.0.0">
<Header>
<Title>up</Title>
<Shortcut>up</Shortcut>
<Description>更新代码注释的代码片段</Description>
<Author>liweihan</Author>
<SnippetTypes>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>Description</ID>
<ToolTip>更新描述</ToolTip>
<Default>更新描述</Default>
</Literal>
<Literal>
<ID>UpdatedBy</ID>
<ToolTip>更新人</ToolTip>
<Default>liweihan</Default>
</Literal>
<Literal>
<ID>UpdatedDate</ID>
<ToolTip>日期</ToolTip>
<Default>@@Today</Default>
</Literal>
</Declarations>
<CodeLanguage="csharp">
<![CDATA[///$Description$@UpdatedBy:$UpdatedBy$@UpdatedDate:$UpdatedDate$$end$]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>


将自定义代码段添加到VS
在VS中打开代码段管理器





选择语言为“CSharp”，选中“MyCodeSnippets”，选择“VisualC#”也可以，这里为了区分自己的代码段和系统代码段我选择了"MyCodeSnippets"，复制位置中的路径，并在资源管理器中打开路径

将自定义的代码段（*.snippet）拷贝到上一步打开的目录中，重启VS就可以了
                                            

                                        

                        
                        内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息 
                    

                    

                    

                        

                         标签： 
                                                

                        

                    


                

            


            

                
相关文章推荐

                

                
            

        

        

            

            
            

                

                    
新的分享

                    

                        
                    

                

            


            

                

                    
章节导航