在Visual Studio中的智能感知,相信大家都用过。summary,param,returns这几个相信很多人都用过的吧。那么field,value等等这些呢。

首先在Visual Studio中支持的JavaScript智能感知有以下6种

summary 用于方法和主体内容
param 用于方法的参数
field 用于类的属性
value 用于getter和setter方法
returns 用于返回值
reference 引用其他JavaScript
 

一、summary

summary只有内容,没有其他属性。
Description:为要提示的内容
 
1
/// <summary>Description</summary>

二、param

param有2个参数 name和type以及内容。

name:对应参数名称

type:参数类型

Description:为要提示的内容

integer:是否为int类型(可选)[默认为false]

optional:参数是否可选(可选)[默认为false]

1
/// <param name="name" type="String">Description</param>

三、field

field有2个参数 name和type以及内容。

name:字段名称

type:字段类型

Description:为要提示的内容

integer:是否为int类型(可选)[默认为false]

1
/// <field name="name" type="String">Description</field>

四、value

value有1个参数 type以及内容。

type:属性类型

Description:为要提示的内容

integer:是否为int类型(可选)[默认为false]

1
/// <value type="String">Description</value>

五、returns

returns有1个参数 type以及内容。

type:返回值类型

Description:为要提示的内容

integer:是否为int类型(可选)[默认为false]

1
/// <returns type="String">Description</returns>

六、reference

reference有2种参数 path或name

path:javascript文件地址

name:内部javascript文件名

1
2
/// <reference path="pathto/script.js"/>
/// <reference name="MicrosoftAjax.js"/>

七、杂项

1)提示换行

这个问题肯定困扰了不少人,在c#的xml注释中是para,但是在javascript中是

1
2
3
4
/// <summary>
/// 这是C#中的注释
/// <para>这是新行</para>
/// </summary>
1
2
3
4
/// <summary>
/// 这是JavaScript中的注释
/// 这是新行
/// </summary>

2)type类型

下面列出常见的类型

Boolean 布朗值
Number 数字类型,用integer可选属性来确实是int还是float
String 字符串类型
Array 数组
Object 对象
Function 方法
Element DOM对象
undefined 不确定

八、完整示例及截图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<script type="text/javascript">
function myClass() {
    /// <summary>
    /// 这是一个类
    /// </summary>
    /// <field name="width" type="Number" integer="true">这是width属性 http://sorex.cnblogs.com/</field>
  
    this.name = "http://sorex.cnblogs.com/";
  
    myClass.prototype.width = 12;
  
    myClass.prototype.get_name = function () {
        /// <summary>
        /// 这是一个getter方法
        /// http://sorex.cnblogs.com/
        /// </summary>
        /// <value type="String">返回值</value>
        return this.name;
    }
  
    myClass.prototype.height = function (h) {
        /// <summary>
        /// 这是height方法
        /// http://sorex.cnblogs.com/
        /// </summary>
        /// <param name="h" type="Number">
        /// 请输入h值
        /// </param>
        /// <returns type="String" />
        return h.toString();
  
        /// <reference path="pathto/script.js"/>
        /// <reference name="MicrosoftAjax.js"/>
    }
}
  
var my = new myClass();
</script>

最新文章

  1. C# BackgroundWorker组件学习入门介绍
  2. Python查找当前路径和子路径下指定后缀名的文件
  3. 快速提高 Xcode 编译速度的方法(转载自网上一个大神的方法)
  4. 将插入的新行放入dataGridView的第一行
  5. JS设计模式书籍、原则
  6. java android 中的Toast
  7. Gridview数据导出到ExcelWord 防止出现乱码
  8. PhpStorm一次性折叠所有函数或者方法
  9. day-5
  10. 如何在windows系统自带命令查看硬件信息?
  11. Apache Arrow 内存数据
  12. hibernate关系映射
  13. ST表 || RMQ问题 || BZOJ 1699: [Usaco2007 Jan]Balanced Lineup排队 || Luogu P2880 [USACO07JAN]平衡的阵容Balanced Lineup
  14. CentOS配置apache多站点设置
  15. [九省联考2018]一双木棋chess
  16. openvswitch vlan下的虚拟机与物理机通信
  17. RandomStringUtils的使用
  18. 转:前端js、jQuery实现日期格式化、字符串格式化
  19. Gradle - Manifest
  20. Android开发 listitem中采用倒计时

热门文章

  1. c# 装箱与拆箱的概念
  2. ZJOI2005沼泽鳄鱼
  3. let---bash中用于计算的工具
  4. Android实战简易教程-第二十五枪(基于Baas的数据表查询下拉刷新和上拉载入实现!)
  5. Android自己定义圆角ImageView 支持网络图片
  6. thinkphp验证码(总结之后,效率非常好)
  7. HttpClient的基本使用
  8. 洛谷 P1927 防护伞
  9. Skill of vim
  10. [转载]Google Java Style 中文版