使用手冊取消

在 Dreamweaver 中使用 ColdFusion 組件

搜尋

上次更新時間 2021年4月29日

Dreamweaver

開啟應用程式

註解：

Dreamweaver CC 和更新版本已移除對 ColdFusion 的支援。

關於 ColdFusion 組件

ColdFusion 組件 (CFC) 檔案可讓您將應用程式和商業邏輯封裝成獨立完整且可重複使用的單元。此外，CFC 同時也提供了一個可以簡易快速建立網路服務的作業方式。

CFC 是使用「ColdFusion 標記語言」(CFML) 撰寫而成的可重複使用軟體單元，讓您可以輕易的重複使用並維護程式碼。

您可以在 Dreamweaver 中搭配使用 CFC。如需 CFC 標籤和語法的詳細資訊，請參閱 Dreamweaver 中的 ColdFusion 文件 (「說明 > 使用 ColdFusion」)。

註解：

您僅能在 ColdFusion MX 或更新版本中使用 CFC。ColdFusion 5 並不支援 CFC。

CFC 就是要提供程式開發人員一個簡單但功能強大的方法，來封裝網站中的各個元素。通常，您會在應用程式或商業邏輯上使用組件，而對象是自訂的問候語、動態選單之類的表現式元素，則使用自訂標籤。

由於網站建構的類型愈來愈多，動態網站因具備有可互換的單元而處處受人青睞。例如，動態網站可以一直重複執行相同的查詢，或是計算購物車網頁中的總金額，而且可以在每次加入新增項目時，重新計算一次總金額。像這一類的工作，就屬於可交由組件來處理的工作。您可以在最不影響應用程式其他部分的情況下，修正、改善、擴充，甚至於置換其中的組件。

假設某個網路商店會依照訂單的金額來計算運費；對金額 $20 以下的訂單而言，運費為 $4，對金額介於 $20 和 $40 之間的訂單而言，運費為 $6，以此類推。您可以同時在購物車和結帳的頁面中插入計算運費的邏輯，但是這麼一來會將 HTML 畫面顯示的程式碼和 CFML 邏輯的程式碼混合在一起，而導致程式碼難以維護及重複使用的缺點。

您決定要建立名為 Pricing 的 CFC，其中除了別的項目以外，還有一個名稱為 ShippingCharge 的函式。這個函式會將購買金額當作是引數傳入，然後傳回計算得出的運費。例如，當引數值為 32.80 時，則函式就會傳回 6。

而您可以在購物車和結帳這兩個網頁中，插入一個特別的標籤來叫用 ShippingCharge 函式。當使用者要求該網頁時，網頁就會叫用該函式，並且將計算所得的運費傳回網頁中。

過了不久，這家網路商店又宣佈推出促銷優惠活動：凡是金額超過 $100 以上的訂單，運費全免。您只需要在一個地方 (亦即 Pricing 組件中的 ShippingCharge 函式) 變更運費的計算方式，就可以讓所有使用這個函式的頁面自動取得正確的運費計算結果。

組件面板總覽 (ColdFusion)

請使用「組件」面板 (「視窗＞組件」) 來檢視和編輯 ColdFusion 組件，並將程式碼加入頁面中，以便在要求 CFM 頁面時叫用函式。

註解：

只有當您在 Dreamweaver 中檢視 ColdFusion 頁面時，才能夠使用「組件」面板。

在 Dreamweaver 中建立或刪除 CFC

您可以使用 Dreamweaver，以視覺化的方式定義 CFC 及其函式。Dreamweaver 會為您建立 .cfc 檔，並插入必要的 CFML 標籤。

註解：

視不同的組件而定，您可能必須以手動方式完成其中部分的程式碼。

在 Dreamweaver 中開啟 ColdFusion 頁面。
在「組件」面板 (「視窗 > 組件」) 中，從彈出式選單選取「CF 組件」。
按一下加號 (+) 按鈕，並完成「建立組件」對話框，然後按一下「確定」。

a. 在「組件」區段中，輸入組件的詳細資料。以下是部分的清單：

名稱：指定組件的檔案名稱。名稱只可以包含英數字元和底線 (_)。輸入名稱時，請勿指定 .cfc 副檔名。

組件目錄：指定儲存組件的地方。請選取網路應用程式的根資料夾 (例如，\Inetpub\wwwroot\myapp\) 或是其任何子資料夾。

b. 若要為組件定義一個或多個函式，請從「區段」清單中選取「函式」，按一下加號 (+) 按鈕，然後輸入新函式的詳細資料。

請確定您在「傳回類型」選項中指定了函式傳回值的類型。

註解：

如果您在「存取」選單中選取「遠端」，則該函式就會變成一個可用的網頁服務。

c. 若要為函式定義一個或多個引數，請從「區段」清單中選取「引數」，再從彈出式選單中選取函式，按一下加號 (+) 按鈕，然後在右邊輸入新引數的詳細資料。
如果您所使用的是遠端開發伺服器，請將 CFC 檔案以及其他相關的檔案 (像是要用來實作函式或包含檔案的檔案) 上傳至遠端伺服器。

將這些檔案上傳，可以確保「即時檢視」和「在瀏覽器中預覽」等 Dreamweaver 功能正常運作。

Dreamweaver 會寫入 CFC 檔，並將該檔案儲存在您所指定的資料夾中。「組件」頁面中也會出現新建的組件 (當您按一下「重新整理」之後)。
如果您所使用的是遠端開發伺服器，請將 CFC 檔案以及其他相關的檔案 (像是要用來實作函式或包含檔案的檔案) 上傳至遠端伺服器。

在 Dreamweaver 中檢視 CFC

Dreamweaver 提供一種方式讓您以視覺化的方式來檢查位於您的網站資料夾或整個伺服器上面的 ColdFusion 組件 (CFC)。Dreamweaver 會讀取 CFC 檔，然後以易於瀏覽的樹狀檢視畫面，將組件的相關資訊顯示在「組件」面板中。

Dreamweaver 會在您的測試伺服器上尋找組件 (請參閱在 Dreamweaver 中連線至資料庫)。如果您建立 CFC 或變更現有的 CFC，請務必將 CFC 檔案上傳到測試伺服器，以便正確地反映到「組件」面板。

若要檢視位於其他伺服器的組件，請變更測試伺服器設定值。

您可以檢視下列有關 CF 組件的任何資訊：

列出伺服器定義的所有 ColdFusion 組件。
如果您執行的是 ColdFusion MX 7 或更新版本，則可以篩選清單，只顯示放置在您網站資料夾中的 CFC。
查看每一個組件的函式和引數。
檢查當做網路服務使用之函式的屬性。

註解：

當您需要使用 Dreamweaver 來檢查駐留於伺服器根目錄的 CFC，並同時管理位於其他網站根目錄的網站檔案時，則您可以定義兩個 Dreamweaver 網站。請將第一個網站設定為指向伺服器根目錄，並讓第二個網站指向網站根目錄。請使用「檔案」面板上的網站彈出式選單，在兩個網站之間快速切換。

若要使用 Dreamweaver 檢視 CFC，請遵循下面的步驟：

在 Dreamweaver 中開啟任何 ColdFusion 頁面。
在「組件」面板 (「視窗＞組件」) 中，從彈出式選單選取「CF 組件」。
按一下面板中的「重新整理」按鈕以擷取組件。

伺服器上便會顯示組件套件。「組件套件」是內含 CFC 檔案的資料夾。

如果沒有顯示現有的組件套件，請按一下面板工具列中的「重新整理」按鈕。
若是只要顯示位於您網站資料夾中的 CFC，請按一下「組件」面板工具列中的「僅顯示目前網站的 CFC」按鈕。

註解：

只有在已將執行 ColdFusion MX 6 或更新版本的電腦定義為 Dreamweaver 的測試伺服器時，才能使用這項功能。

註解：

如果目前的網站列於遠端伺服器的虛擬資料夾中，篩選功能則無法正常執行。
按一下套件名稱旁邊的加號 (+) 按鈕，便可檢視儲存於該套件中的組件。
- 若要列出組件中的函式，請按一下組件名稱旁邊的加號 (+) 按鈕。
- 若要查看函式中使用的引數、引數的類型，以及引數是否為必要的或選擇性的，請在樹狀檢視中開啟函式的分支。
  如果是沒有使用引數的函式，該函式的旁邊就不會出現加號 (+) 按鈕。
- 若要快速檢視引數、函式、組件或套件的詳細資料，請在樹狀檢視中選取項目，然後按一下面板工具列中的「取得詳細資料」按鈕。
  您也可以在項目上按一下右鍵 (Windows) 或 Control+按一下 (Macintosh)，然後從彈出式選單中選取「取得詳細資料」。
  項目的詳細資料便會顯示在訊息方塊中。

在 Dreamweaver 中編輯 CFC

Dreamweaver 提供您一種編輯已定義於網站之 ColdFusion 組件程式碼的優良作業環境。例如，您不需離開 Dreamweaver，即可對任何組件函式進行新增、變更或刪除。

若要使用這項功能，請依照下列步驟設定您的開發環境：

ColdFusion 必須在本機上執行。
在 Dreamweaver 的進階「網站定義」對話框中，於「測試伺服器」類別內所指定的「存取」類型必須是「本機/區域網路」。
在進階「網站定義」對話方塊內，本機根資料夾的路徑必須和測試伺服器資料夾的路徑相同 (例如，c:\Inetpub\wwwroot\cf_projects\myNewApp\)。如果您要檢查或變更這些路徑，請選取「網站＞編輯網站」。
您必須將組件儲存於本機網站的資料夾中，或者是硬碟中本機網站的子資料夾內。

在 Dreamweaver 中開啟任何 ColdFusion 頁面，並將組件顯示於「組件」面板中。若要顯示組件，請開啟「組件」面板 (「視窗 > 組件」)，從面板的彈出式選單中選取「CF 組件」，然後按一下面板上的「重新整理」按鈕。

由於 ColdFusion 是在本機執行，Dreamweaver 會顯示儲存於硬碟上的組件套件。

請使用下列程序來編輯組件。

在 Dreamweaver 中開啟任何 ColdFusion 頁面，並將組件顯示於「組件」面板 (「視窗 > 組件」) 中。
從面板的彈出式選單中選取「CF 組件」，然後按一下面板上的「重新整理」按鈕。

由於 ColdFusion 是在本機執行，Dreamweaver 會顯示儲存於硬碟上的組件套件。

註解：

若要以視覺方式來編輯 CFC 資料集，請在「繫結」面板中按兩下 CFC 資料集。
通常，若要編輯組件檔案，請開啟組件套件，然後按兩下樹狀檢視中的組件名稱。

組件的檔案便會在「程式碼」檢視中開啟。
若要編輯特定的函式、引數或屬性，請按兩下樹狀檢視中的項目。
在「程式碼」檢視中以手動方式進行變更。
儲存檔案 (「檔案＞儲存」)。
若要在「組件」面板中查看新的函式，請使用面板工具列上的「重新整理」按鈕，重新整理組件面板的畫面。

建立使用 CFC 的網頁

若要在網頁中使用組件函式，有一種做法就是直接將組件函式的程式碼寫在網頁之中，以便在要求該網頁時叫用函式。您可以使用 Dreamweaver 協助您撰寫這個程式碼。

註解：

如需使用組件的其他方法，請參閱 Dreamweaver 中的 ColdFusion 文件 (「說明 > 使用 ColdFusion」)。

在 Dreamweaver 中，開啟要使用組件函式的 ColdFusion 頁面。
切換到「程式碼」檢視(「檢視＞程式碼」)。
開啟「組件」面板 (「視窗＞組件」)，然後從面板的彈出式選單中選取「CF 組件」。
尋找您所需的組件，然後使用下列其中一種方法插入組件：
- 使用拖曳功能，將組件從樹狀檢視拖曳到頁面中。該頁面中便會插入用來呼叫函式的程式碼。
- 選取面板中的函式，然後按一下面板工具列上的「插入」按鈕 (右邊算起第二個按鈕)。Dreamweaver 會在插入點的位置，將程式碼插入至頁面中。
如果您插入的函式包含引數，則必須以手動方式完成引數程式碼。

如需詳細資訊，請參閱 Dreamweaver 中的 ColdFusion 文件 (「說明 > 使用 ColdFusion」)。
儲存頁面 (「檔案＞儲存」)。

在 CFC 中定義資料集

Dreamweaver 可以協助您在 ColdFusion 組件 (CFC) 中定義資料集 (也稱為 ColdFusion 查詢)。一旦在 CFC 中定義了資料集，您就不需要在使用資料集的每個頁面上逐一定義。只要在 CFC 中定義過一次資料集，就可以在不同的頁面上使用 CFC。

註解：

唯有當您可以存取執行 ColdFusion MX 7 或更新版本的電腦時，才能使用這項功能。如需詳細資訊，請參閱啟用 ColdFusion 增強功能。

在 Dreamweaver 中建立或開啟現有的 CFC 檔案。
在「繫結」面板 (「視窗＞繫結」) 中，按一下加號 (+) 按鈕，然後從彈出式選單中選取「資料集 (查詢)」。

「資料集」對話方塊便會出現。不論是簡單或進階的「資料集」對話方塊，您都可以使用。
若要在 CFC 中使用現有的函式，請從「函式」彈出式選單中選取函式，然後跳至步驟 5。

資料集是在函式中定義。
若要在 CFC 中定義新的函式，請按一下「新函式」按鈕，在出現的對話方塊中輸入函式名稱，然後按一下「確定」。

名稱只可以包含英數字元和底線 (_)。
若要為函式定義資料集，請完成「資料集」對話方塊選項。

定義資料集的新函式便會插入到 CFC 中。

使用 CFC 資料集做為動態內容的來源

如果組件中含有定義資料集的函式，您可以使用 ColdFusion 組件 (CFC) 做為頁面動態內容的來源。

註解：

唯有當您可以存取執行 ColdFusion MX 7 或更新版本的電腦時，才能使用這項功能。「啟用 ColdFusion 增強功能」。

在 Dreamweaver 中開啟 ColdFusion 頁面。
在「繫結」面板 (「視窗＞繫結」) 中，按一下加號 (+) 按鈕，然後從彈出式選單中選取「資料集 (查詢)」。

「資料集」對話方塊便會出現。不論是簡單或進階的「資料集」對話方塊，您都可以使用。
按一下「CFC 查詢」按鈕。
完成「CFC 查詢」對話方塊，按一下「確定」，然後再按一下「確定」，將 CFC 資料集加入至「繫結」面板中可用的內容來源清單。
使用「繫結」面板將資料集繫結到各種不同的頁面元素。

如需詳細資訊，請參閱將動態內容新增至頁面。

使用 CFC 定義動態內容

您可以使用含有資料集定義的 CFC，將資料集定義為 Dreamweaver 中的動態內容來源。

1. 在「名稱」方塊中，輸入 CFC 資料集的名稱。

一般的做法是在資料集名稱加上前置詞 rs，以便與程式碼中的其他物件名稱有所區別，例如：rsPressRelease。

資料集名稱只可以包含英數字元和底線 (_)。不可以使用特殊字元或空格。

2. 從伺服器上已經完成定義的資料集當中選取套件。

如果套件沒有出現在彈出式選單中，您可以按一下彈出式選單附近的「重新整理」按鈕，重新整理套件清單。

首先請確定您已將 CFC 上傳到測試伺服器。只有位於測試伺服器上的 CFC 才會顯示在畫面中。

3. 從目前所選取的套件中，選取已經完成定義的組件。

如果「組件」彈出式選單中沒有出現任何組件，或者選單中沒有出現任何您先前所建立的組件，則應該將 CFC 檔案上傳到測試伺服器中。

4.(選擇性) 若要建立組件，請按一下「建立新組件」按鈕。

a. 在「名稱」方塊中，輸入新 CFC 的名稱。名稱只可以包含英數字元和底線 (_)。

b. 在「組件目錄」方塊中輸入 CFC 的位置，或是以瀏覽方式找出資料夾。

註解：

該資料夾必須是網站根資料夾的相對路徑。

5. 從「函式」彈出式選單中選取含有資料集定義的函式。

「函式」彈出式選單中僅包含定義於目前所選取組件中的函式。如果彈出式選單中沒有出現任何函式，或者您最近所做的變更並沒有反映在目前列出的清單中，請檢查您最近所做的變更是否已經儲存，並已上傳至伺服器。

註解：

「連線」及 SQL 方塊都是唯讀的。

6. 按一下「編輯」按鈕，編輯每一個必須以函式引數傳送的參數 (類型、值和預設值)。

a. 從「值」彈出式選單中選取數值類型，然後在右邊的方塊中輸入該值，即可輸入目前參數的值。數值類型可以是 URL 參數、表單變數、Cookie、Session 變數、應用程式變數或輸入的值。

b. 在「預設值」方塊中輸入參數的預設值。如果沒有傳回執行階段值，則會使用預設的參數值。

c. 按一下「確定」。

您無法修改資料庫連線和資料集的 SQL 查詢。這些欄位永遠呈停用狀態，只能顯示連線和 SQL 查詢供您參考。

7. 按一下「測試」，連線至資料庫，並建立資料集的實體。

如果 SQL 陳述式含有頁面參數，在按下「測試」之前，請確認參數方塊的「預設值」欄應包含有效的測試值。

如果查詢執行成功，則會以表格將資料集顯示在畫面上。每一列含有一筆記錄，每一欄各代表該筆記錄中的一個欄位。

按一下「確定」，清除 CFC 查詢。

8. 按一下「確定」。

更快、更輕鬆地獲得協助

新的使用者？