转创建 JavaScript XML 文档注释

http://www.cnblogs.com/chenxizhang/archive/2009/07/12/1522058.html

Visual Studio 2012

如何：创建 JavaScript XML 文档注释

在 Visual Studio，这些文本说明显示与 IntelliSense 时，引用的脚本函数。

<returns> (JavaScript)。

说明
只能从引用的文件、程序集和服务可用 XML 文档注释。

若要创建 XML 文档注释的 JavaScript 函数

<returns> (JavaScript)元素，并在前面三个斜杠 (/ /) 与每个元素。

说明

每个元素必须全部在一行上。

下面的示例演示一个 JavaScript 函数。
1. function getArea(radius)
2. {
3. /// <summary>Determines the area of a circle that has the specified radius parameter.</summary>
4. /// <param name="radius" type="Number">The radius of the circle.</param>
5. /// <returns type="Number">The area.</returns>
6. var areaVal;
7. areaVal = Math.PI * radius * radius;
8. return areaVal;
9. }
要查看 XML 文档注释，请键入名称和左括号的函数，如下例所示的 XML 文档注释标记：
1. var areaVal = getArea(
在键入左括号的函数包含 XML 文档注释的时，代码编辑器中使用 IntelliSense 显示 XML 文档注释中定义的信息。

说明
每个元素必须全部在一行上。

若要创建 JavaScript 字段的 XML 文档注释

<field> (JavaScript)元素前面三个斜杠 (/ /)。

<field> (JavaScript)。
1. function Engine() {
2. /// <field name='HorsePower' type='Number'>The engine's horsepower.</field>
3. this.HorsePower = 150;
4. }
若要查看 XML 文档注释，请通过使用 XML 文档注释，如下例所示使用函数构造函数标记为创建对象。
1. var eng = new Engine();
在下一行中，键入该对象，以显示该字段的 IntelliSense 信息段的名称。
1. eng.

若要创建 XML 文档注释的重载函数

<returns>前三个斜杠 (/ /) 与每个元素。

在此示例中，参数类型不同的重载。
1. function calc(a) {
2. /// <signature>
3. /// <summary>Function summary 1.</summary>
4. /// <param name="a" type="Number">A number.</param>
5. /// <returns type="Number" />
6. /// </signature>
7. /// <signature>
8. /// <summary>Function summary 2.</summary>
9. /// <param name="a" type="String">A string.</param>
10. /// <returns type="Number" />
11. /// </signature>
12. return a;
13. }
要查看 XML 文档注释，请键入名称和左括号的函数的使用，如下例所示的 XML 文档注释标记：
1. calc(

若要创建本地化的 IntelliSense

创建具有 OpenAjax MessageBundle 格式的文档注释的 XML 文件。

重要事项
<loc> (JavaScript)。

<loc>元素。

<messagebundle>
  <msg name="1">A class that represents a rectangle</msg>
  <msg name="2">The length of the rectangle</msg>
  <msg name="3">The height of the rectangle</msg>
</messagebundle>

<loc> (JavaScript)。
1. /// <loc filename="messageFilename.xml" format="messagebundle"/>
如果可用本地化的 IntelliSense 信息将被替换的默认说明。
1. function add(a,b)
2. {
3. /// <summary locid='1'>description</summary>
4. /// <param name='a' locid='2'>parameter a description</param>
5. /// <param name='b' locid='3'>parameter b description</param>
6. }
要查看 XML 文档注释，请键入名称和左括号的函数，如下例所示：
1. add(

请参见

概念

JavaScript IntelliSense

XML 文档注释 (JavaScript)

其他资源

演练：ASP.NET 中的 JavaScript IntelliSense