在 Dreamweaver 中開啟 ColdFusion 頁面。
上次更新時間
2024年4月25日
備註
在 Dreamweaver 及更高版本中，已移除對 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 標記。
備註
視不同的組件而定，您可能必須以手動方式完成其中部分的程式碼。
在「元件」面板 (「視窗」>「元件」) 中，從彈出式選單中選取「CF 元件」。
按一下「加號 (+)」按鈕，完成「建立元件」對話框，然後按一下「確定」。
a. 在「組件」區段中，輸入組件的詳細資料。 以下是部份的清單：
名稱：指定組件的檔案名稱。 名稱只可以包含英數字元和底線 (_)。 輸入名稱時，請勿指定 .cfc 副檔名。
組件目錄：指定儲存組件的地方。 請選取網路應用程式的根資料夾 (例如，\Inetpub\wwwroot\myapp\) 或是其任何子資料夾。
b.若要為元件定義一或多個函數，請從「區段」清單中選取「函數」，按一下「加號 (+)」按鈕，然後輸入新函數的詳細資料。
請確定您在「傳回類型」選項中指定了函式傳回值的類型。
備註
如果您在「存取」選單中選取「遠端」，則該函式就會變成一個可用的網頁服務。
c.若要為函數定義一或多個自變數，請從「區段」清單中選取 「自變數」，從彈出式 選單中選取函數，按一下「加號 (+)」按鈕，然後在右邊輸入新自變數 的詳細資料。
如果您使用遠端開發伺服器，請將 CFC 檔案和任何相依的檔案 (例如用於實施函數或 include 檔案) 上傳到遠端伺服器。
上傳檔案可確保 Dreamweaver 功能 (例如「即時檢視」和「在瀏覽器中預覽」) 正常運作。
Dreamweaver 會寫入 CFC 檔案並將其儲存 在您指定的檔案夾中。新元件也會出現在 「元件」面板中 (按一下「重新整理」後)。
如果您使用遠端開發伺服器，請將 CFC 檔案和任何相依的檔案 (例如用於實施函數或 include 檔案) 上傳到遠端伺服器。
在 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 的網頁
若要在網頁中使用組件函式，有一種做法就是直接將組件函式的程式碼寫在網頁之中，以便在要求該網頁時叫用函式。 您可以使用 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 定義動態內容
您可以在 Dreamweaver 中使用包含記錄集定義的 CFC 將記錄集定義為 動態內容的來源。
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.按一下「確定」。
