<param> (JavaScript)
指定参数的文档信息在函数或方法。
<param name="parameterName" type="ParameterType" integer="true|false" domElement="true|false" mayBeNull="true|false" elementType="ArrayElementType" elementInteger="true|false" elementDomElement="true|false" elementMayBeNull="true|false" locid="descriptionID" parameterArray="true|false" optional="true|false" value="code">description</param>
参数
name
必需。 参数的名称。type
可选。 参数的数据类型。 该类型可以是下列操作之一：ECMAScript 语言类型 ECMAScript 5 规范，如 Number 和 Object。
一个 DOM 对象，例如 HTMLElement、Window和 Document。
JavaScript 构造函数。
integer
可选。 如果 type 是 Number，指定参数是否是整数。 设置为 true 指示该参数是整数，否则，将设置为 false。 Visual Studio 不使用此属性提供 IntelliSense 信息。domElement
可选。 此属性已否决；type 属性优先于此属性。 此特性指定将文档的参数是否是 DOM 元素。 设置为 true 指定参数是 DOM 元素；否则，将设置为 false。 如果 type 未设置属性，并 domElement 设置为 true，IntelliSense 将文档的参数作为 HTMLElement，在执行语句完成。mayBeNull
可选。 指定该文档的参数是否可以设置为 null。 设置为 true 指示该参数可设置为 null;否则，将设置为 false。 默认值为 false。 Visual Studio 不使用此属性提供 IntelliSense 信息。elementType
可选。 如果 type 是 Array，此属性在该数组指定元素的类型。elementInteger
可选。 如果 type 是 Array，并 elementType 是 Number，此属性指定该数组的元素是整数。 设置为 true 它表明数组中的元素是整数，否则，将设置为 false。 Visual Studio 不使用此属性提供 IntelliSense 信息。elementDomElement
可选。 此属性已否决；elementType 属性优先于此属性。 如果 type 是 Array，此属性指定该数组的元素是否是 DOM 元素。 设置为 true 指定元素是 DOM 元素；否则，将设置为 false。 如果 elementType 未设置属性，并 elementDomElement 设置为 true，IntelliSense 将数组的每个元素作为 HTMLElement，在执行语句完成。elementMayBeNull
可选。 如果 type 是 Array，指定该数组的元素是否可以设置为 null。 设置为 true 它表明数组的元素可以设置为 null;否则，将设置为 false。 默认值为 false。 Visual Studio 不使用此属性提供 IntelliSense 信息。locid
可选。 标识符有关参数的本地化信息。 该标识符是或成员 ID 或它对应于 OpenAjax 元数据在消息绑定的 name 属性值定义。 标识符类型取决于 <loc> (JavaScript) 元素指定的格式。parameterArray
可选。 指定该文档的参数是否在可以重复的函数调用，类似于循环访问 String.format 功能支持的参数。 设置为 true 指示该参数可以重复使用；否则，将设置为 false。 Visual Studio 不使用此属性提供 IntelliSense 信息。optional
可选。 指定该文档的参数是否可选在调用函数。 设置为 true 指示该参数是可选的；否则，将设置为 false。value
可选。 指定何时计算供 IntelliSense 而不是函数代码使用的代码。 当参数类型是未定义时，可以使用此属性将提供类型信息。 例如，可以使用 value=’1’ 将参数类型为数字。description
可选。 参数的说明。
备注
唯一的必选特性。name。 其他属性是可选的。
在任何语句之前函数体必须将用于的元素来批注函数，如 <summary> (JavaScript)，<param> (JavaScript)和 <returns> (JavaScript)。
如果有多个同名的 <param> 元素，使用一个 <param> 元素，并冗余元素将被忽略。 定位行为使用哪个元素未定义。 如果 name 引用了不存在的参数，元素被忽略。
示例
下面的代码示例演示如何使用 <param> 元素。
function areaFunction(radiusParam)
{
/// <summary>Determines the area of a circle when provided a radius parameter.</summary>
/// <param name="radius" type="Number">The radius of the circle.</param>
/// <returns type="Number">The area.</returns>
var areaVal;
areaVal = Math.PI * radiusParam * radiusParam;
return areaVal;
}
// Uses of <param> with the value attribute.
function calculate(a) {
/// <param name='a' value='1'/>
a. // Completion list for a Number.
}
function calculate(a) {
/// <param name='a' value='{x:0,y:0}'/>
a. // x and y appear in the completion list.
}