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

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

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

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

 

一、summary

summary只有内容，没有其他属性。

Description：为要提示的内容

 

/// <summary>Description</summary>

二、param

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

name：对应参数名称

type：参数类型

Description：为要提示的内容

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

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

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

三、field

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

name：字段名称

type：字段类型

Description：为要提示的内容

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

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

四、value

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

type：属性类型

Description：为要提示的内容

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

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

五、returns

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

type：返回值类型

Description：为要提示的内容

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

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

六、reference

reference有2种参数 path或name

path：javascript文件地址

name：内部javascript文件名

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

七、杂项

1）提示换行

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


/// <summary>
/// 这是C#中的注释
/// <para>这是新行</para>
/// </summary>

/// <summary>
/// 这是JavaScript中的注释
/// &#10;这是新行
/// </summary>

2）type类型

下面列出常见的类型

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

八、完整示例及截图

<script type="text/javascript">
function myClass() {
	/// <summary>
	/// 这是一个类
	/// &#10;http://sorex.cnblogs.com/
	/// </summary>
	/// <field name="width" type="Number" integer="true">这是width属性&#10;http://sorex.cnblogs.com/</field>

	this.name = "http://sorex.cnblogs.com/";

	myClass.prototype.width = 12;

	myClass.prototype.get_name = function () {
		/// <summary>
		/// 这是一个getter方法
		/// &#10;http://sorex.cnblogs.com/
		/// </summary>
		/// <value type="String">返回值</value>
		return this.name;
	}

	myClass.prototype.height = function (h) {
		/// <summary>
		/// 这是height方法
		/// &#10;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>