伺服器端註解

伺服器端註解讓開發人員能將程式碼註解內嵌在 ASP.NET 應用程式檔案的任何部分 (<script> 程式碼區塊內部除外)。 伺服器端註解項目開頭和結尾標記之間的任何內容 (不論是 ASP.NET 程式碼還是常值文字) 將不會在伺服器上處理,也不會轉譯至產生的網頁。

<%-- Content of comments, or commented out server controls --%>

備註

ASP.NET 伺服器端註解區塊與傳統語言專屬註解區塊的用途相同,包括做為文件和測試之用。 例如,您可以使用伺服器端註解描述檔案中標記的區段,或是將網頁中宣告的一或多個伺服器控制項都標記為註解。 這些註解可以在大多數類型的 ASP.NET 應用程式檔案中使用,包括 Web 網頁、使用者控制項、主版頁面 (Master Page) 和面版檔案

請注意,伺服器端的註解可以在網頁的主體中使用,而不能在伺服器端程式碼的區塊內使用。 當您在程式碼宣告區塊 (<script runat="server"></script> 標記內所包含的程式碼) 或程式碼轉譯區塊 (<% %> 標記內所包含的程式碼) 內使用特定的語言時,應該使用所撰寫之語言的註解語法。

如果您在 <% %> 區塊之內使用伺服器端註解區塊,就會產生編譯 (Compilation) 錯誤。

開頭和結尾註解標記可以出現在程式碼的同一行,也可以隔著許多被改成註解的行。

伺服器端註解區塊不能有巢狀結構。

範例

下列程式碼範例示範以伺服器端註解標記為註解的 Button 控制項。

<%-- 
<asp:button runat="server" id="MyButton" 
  OnClick="MyButton_Click" />
--%>  

請參閱

其他資源

ASP.NET 網頁語法