伺服器端 Include 指示詞語法

在 ASP.NET 檔案內插入指定之檔案的內容,包括 Web 網頁 (.aspx 檔案)、使用者控制項檔案 (.ascx 檔案) 和 Global.asax 檔案等等。

<!-- #include file|virtual="filename" -->

屬性

  • File
    檔名是具有 #include 指示詞之檔案所在目錄的實體路徑。 這個路徑可以是相對路徑。

    注意

    包含的檔案可位於相同的目錄或子目錄,不能位於具有 #include 指示詞之檔案的上層目錄。

  • Virtual
    檔名是在您網站中虛擬目錄的虛擬路徑。 這個路徑可以是相對路徑。

    注意

    因為檔案的實體路徑可能會有變更,因此建議使用這個技巧。

備註

指派給 File 或 Virtual 屬性的值必須放在引號 ("") 中。 被包含的檔案會在執行任何動態程式碼之前被處理。 Include 檔可以用來包含任何項目,從靜態文字 (例如通用頁首或公司地址) 到通用伺服器端程式碼、控制項,或是開發人員要插入其他網頁的 HTML 標記區塊都有可能。

注意

儘管您可以因為重複使用程式碼的目的而繼續使用 #include 標記 (藉由放置通用伺服器端程式碼、控制項,或是要包含在其他 Web 網頁中的檔案內 HTML 標記),ASP.NET 慣用的處理方法卻是使用 Web 使用者控制項。使用者控制項提供物件導向的程式設計模型,以及比伺服器端 Include 更強的功能。如需詳細資訊,請參閱 ASP.NET User Controls

#include 標記必須位於 HTML 或 XML 註解分隔符號 (Comment Delimiter) 以內,以避免被解譯為常值 (Literal) 文字。

範例

下列程式碼範例示範如何使用伺服器端 Include 指示詞的語法,呼叫會在 ASP.NET Web 網頁上建立頁首和頁尾的檔案。 兩者都是使用相對路徑。

<html>
   <body>
      <!-- #Include virtual="/include/header.inc" -->
        Here is the main body of the .aspx file.
      <!-- #Include virtual="/include/footer.inc" -->
   </body>
</html>

請參閱

概念

ASP.NET Web Page Syntax Overview

其他資源

ASP.NET User Controls