vs2017通过snippet代码片断进行标准化注释

简介:

我们在进行团队开发时,类的注释已经可以做到自定义了,详细看上篇文章《vs2017通过模块文件添加自定义注释》,而对于方法的注释,我们也需要完善一下,这里我们用到了“代码片断”插件,VS里有很多命令的缩写,如for加两次tab,ctor加两次tab,事实上tab表示执行的意思,而前面的字母表示一个代码片断,我们可以把一些公用的代码进行抽像,做成一个代码片断!

一 打开代码片断对话框架,ctrl+K,ctrl+B

二 把它自己封装的代码片断文件“导入”,然后重启VS,你的代码片断就可以使用了,下面看我的注释功能的片断

<?xml version="1.0" encoding="utf-8"?>
    <CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
        <CodeSnippet Format="1.0.0">
            <Header>
                <Title>方法标准注释</Title>
                <Shortcut>rr</Shortcut>
                <Description>更新代码注释 的代码片段</Description>
                <Author>lind</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>zzl</Default>
                    </Literal>
                    <Literal>
                        <ID>UpdatedDate</ID>
                        <ToolTip>日期</ToolTip>
                        <Default>@@Today</Default>
                    </Literal>
                </Declarations>
                <Code Language="csharp">
              <![CDATA[      
                ///<summary>
                /// 功能    :$Description$
                 /// 更新人  :$UpdatedBy$
                /// 更新时间:$UpdatedDate$
                ///</summary> $end$  ]]>
                </Code>
            </Snippet>
        </CodeSnippet>
    </CodeSnippets>

代码中,Title是在对话框里的说明信息,Shortcut是编辑器里输入的快捷命令,如rr,再按两次tab,就可以把自定义的注释添加了!

添加后的效果

感谢各位的阅读,有了这个功能,我们的代码注释就更加规范了!

本文转自博客园张占岭(仓储大叔)的博客,原文链接:vs2017通过snippet代码片断进行标准化注释,如需转载请自行联系原博主。

目录
相关文章
|
4月前
|
设计模式 算法 前端开发
有什么可以减少注释,但依然能让他人看得懂代码的方法吗?
有什么可以减少注释,但依然能让他人看得懂代码的方法吗?
30 0
|
9月前
|
C#
C#基础Ⅱ-注释、快捷键、结构
C#基础Ⅱ-注释、快捷键、结构
|
11月前
|
前端开发 C++
VS Code配置snippets代码片段快速生成html模板,提高前端编写效率
VS Code配置snippets代码片段快速生成html模板,提高前端编写效率
164 0
|
Java
Java注释的三种方式
Java注释的三种方式
80 0
Java注释的三种方式
|
PHP 流计算 开发者
在PhpStorm中使用PSR2编码规范phpcbf脚本自动修正代码格式
在PhpStorm中使用PSR2编码规范phpcbf脚本自动修正代码格式
154 0
在PhpStorm中使用PSR2编码规范phpcbf脚本自动修正代码格式
|
Oracle Java 关系型数据库
为什么Java注释里的代码被执行了?
为什么Java注释里的代码被执行了?
319 0
为什么Java注释里的代码被执行了?
|
C++
VS Code 折腾记 - (6) 基本配置/快捷键定义/代码片段的录入
本来分成三篇来写的,但是想了想没必要,大家都是聪明人,简单的东西点一下就晓得了。
118 0
Geany整体注释和取消注释快捷键
Geany整体注释和取消注释快捷键
415 0
Geany整体注释和取消注释快捷键
一个利用正则表达式进行代码重构,去除冗余代码的例子
一个利用正则表达式进行代码重构,去除冗余代码的例子
294 0
一个利用正则表达式进行代码重构,去除冗余代码的例子
|
JavaScript 前端开发

热门文章

最新文章