參考手冊

INCLUDE 陳述式

目的

讀取且納入檔案到指定陳述式的 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
此關鍵字用於顯示被讀取且納入 Net.Data 巨集中的檔案。

名稱
一個以英文字母或底線開頭的英文或數字字串, 可以是英文字母、數字或底線字元的任意組合。

字串
字串中可使用任何英文字母、數字與標點符號,但不能使用換行字元。

變數參照
傳回變數值,並以 $ 及 () 符號指定。例如: 如果 VAR='abc', 則 $(VAR) 傳回值 'abc'。 有關語法的詳細資訊, 請參閱變數參照

上下文

在這些上下文中可找到 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"


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]