Visual Studio中你所不知道的智能感知

时间:2021-04-02 03:23:35

在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>

Visual Studio中你所不知道的智能感知

Visual Studio中你所不知道的智能感知

Visual Studio中你所不知道的智能感知

Visual Studio中你所不知道的智能感知