服务器端注释
允许您将代码注释包括在 .aspx 文件的正文中。服务器端注释元素的开始标记和结束标记之间的任何内容,不管是 ASP.NET 代码还是文本,都不会在服务器上进行处理或呈现在结果页上。
<%-- commented out code or content --%>
备注
ASP.NET 服务器端注释块与传统的语言特定注释块具有相同的用法(包括文档和测试)。
在 <script runat="server"> </script> 和 <% %> 块中,可以使用正用于编码的语言的注释语法。
如果在 <% %> 块中使用服务器端注释块,则会出现编译错误。
开始和结束注释标记可以出现在同一行代码中,也可以由许多被注释掉的行隔开。
服务器端注释块不能被嵌套。
示例
下面的示例说明被注释掉的 HtmlButton 控件。
<%-- <button runat="server" id="MyButton" OnServerClick="MyButton_Click">
Click here for enlightenment!
</button>
--%>
JScript 注释
单行 JScript 注释以两个正斜杠 (//) 开始。以下是单行注释(后跟一行代码)的一个示例。
// This is a single-line comment.
aGoodIdea = "Comment your code for clarity.";
多行 JScript 注释以正斜杠和星号 (/*) 开头,以相反的顺序 (*/) 结束。
/*
This is a multiline comment that explains the preceding code statement.
The statement assigns a value to the aGoodIdea variable. The value,
which is contained between the quote marks, is called a literal. A
literal explicitly and directly contains information; it does not
refer to the information indirectly. The quote marks are not part
of the literal.
*/
如果试图在一个多行注释中嵌入另一个多行注释,JScript 将以一种意想不到的方式解释生成的多行注释。标记嵌入的多行注释结尾的 */ 将被解释为整个多行注释的结尾。因此,在嵌入的多行注释后面的文本将被解释为 JScript 代码,并可能生成语法错误。
在下面的示例中,由于 JScript 将最里面的 */ 解释为最外面注释的结尾,因此第三行文本将被解释为 JScript 代码:
/* This is the outer-most comment
/* And this is the inner-most comment */
...Unfortunately, JScript will try to treat all of this as code. */
建议将所有注释编写为单行注释的块。这样就允许随后用一个多行注释来注释大段代码。
// This is another multiline comment, written as a series of single-line comments.
// After the statement is executed, you can refer to the content of the aGoodIdea
// variable by using its name, as in the next statement, in which a string literal is
// appended to the aGoodIdea variable by concatenation to create a new variable.
var extendedIdea = aGoodIdea + " You never know when you'll have to figure out what it does.";
或者还可以使用条件编译安全有效地注释大段代码。