详解ASP.NET注释语句及服务器注释

服务器端ASP.NET注释语句

允许您将ASP.NET注释语句包括在 .aspx 文件的正文中。服务器端注释元素的开始标记和结束标记之间的任何内容，不管是 ASP.NET 代码还是文本，都不会在服务器上进行处理或呈现在结果页上。

<%-- commented out code or content --%> 

备注

ASP.NET服务器端注释块与传统的语言特定注释块具有相同的用法（包括文档和测试）。

在

如果在 块中使用服务器端ASP.NET注释块，则会出现编译错误。

开始和结束ASP.NET注释标记可以出现在同一行代码中，也可以由许多被注释掉的行隔开。

服务器端注释块不能被嵌套。

ASP.NET注释示例

下面的示例说明被注释掉的 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. */ 

建议将所有ASP.NET注释语句编写为单行注释的块。这样就允许随后用一个多行ASP.NET注释来注释大段代码。