目的
讀取且納入檔案到指定陳述式的 Net.Data 巨集中。
Net.Data 在起始設定檔 INCLUDE_PATH 陳述式指定的目錄中,尋找併入檔。
您併入檔的使用方式,可以與大部份的高階語言相同。 您可以插入共用標題及註腳、定義共用變數設定、 或將 FUNCTION 區塊定義的共用次常式程式庫納入 Net.Data 巨集中。
在處理巨集時,Net.Data 只執行一次 INCLUDE 陳述式, 並在巨集中 INCLUDE 陳述式的位置插入參考檔案的內容。 分析參考檔案名稱的任何變數參照的時刻 最先是在執行 INCLUDE 陳述式時, 而不是在執行參考檔案內容時。
當 INCLUDE 陳述式位於 ROW 或 WHILE 區塊中時, Net.Data 不會重複執行 INCLUDE 陳述式。Net.Data 第一次執行 ROW 或 WHILE 區塊時會執行 INCLUDE 陳述式, 納入參考檔案內容到區塊,然後用參考檔案內容重複執行 ROW 或 WHILE 區塊。
授權要訣:確定 Net.Data 執行時所用的使用者 ID, 有權存取 INCLUDE 陳述式所參照的任何檔案。有關設定 Web 伺服器使用 Net.Data 檔案之存取權的詳細資料, 請參閱 Net.Data 管理及程式設計指南中的架構章節部分。
語法
.---------------. V | >>-%INCLUDE----"----+-字串-----+--+---"------------------------>< '-變數參照-'
值
上下文
在這些上下文中可找到 INCLUDE 陳述式:
限制
INCLUDE 陳述式可以包含這些元素:
不容許字串中的函數呼叫。
您最多可以用巢狀方式設定 10 個 INCLUDE 陳述式。
範例
範例 1:HTML 區塊中的 INCLUDE 陳述式
%HTML(start){ %INCLUDE "header.hti" ... %}
範例 2:REPORT 區塊中的 INCLUDE 陳述式
%REPORT { %INCLUDE "report_header.txt" %ROW { %INCLUDE "row_include.txt" %} %INCLUDE "report_footer.txt" %}
範例 3: INCLUDE 陳述式中的變數參照
%define REMOTE_USER = %ENVVAR %include "$(REMOTE_USER).hti"