Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

How to: Create JScript XML Code Comments

XML code comments are JScript (JavaScript) comments that you add to script functions to provide a summary and information about the function's parameters and return value. In Visual Studio, these text descriptions are displayed with IntelliSense when you reference the script function.

NoteNote:

XML code comments are available only from referenced files, assemblies, and services.

To create XML code comments for a JScript function

  • Inside include summary, param, and returns elements, and precede each element with three slashes (///).

    NoteNote:

    The elements must be on a single line.

    The following example shows a JScript function that includes each of the three elements that is supported in XML code comments.

    <script type="text/javascript">
      function areaFunction(radiusParam)
      {
          /// <summary>Determines the area of a circle based on 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;
      }
    </script>
    

To view XML code comments using IntelliSense

  • Type the name and the opening parenthesis of a function that is marked with XML code comments, as in the following example:

    var areaVal = areaFunction(
    

    When you type the opening parenthesis of the function that contains the XML code comments, the editor uses IntelliSense to display the information that is defined in XML code comments.

Community Additions

ADD
Show:
© 2015 Microsoft