在 Dreamweaver 中打开 ColdFusion 页面。
\n
上次更新日期：
2024年4月25日
注释
Dreamweaver 及更高版本中已移除对 ColdFusion 的支持。
关于 ColdFusion 组件
ColdFusion\n组件 (CFC) 文件可让您将应用程序和商业逻辑\n封装到独立的可重用单元中。CFC 也提供了一种快速、简便的\n方法来创建 web 服务。
CFC 是使用 ColdFusion 标记\n语言 (CFML) 编写的可重用软件单元，可轻松重用和维护您的\n代码。
可以将 Dreamweaver 和 CFC 一起使用。 有关 CFC 标记和语法的信息，请参阅 Dreamweaver 中的 ColdFusion 文档\n（帮助 >\n使用 ColdFusion）。
注释
CFC 只能用于 ColdFusion MX 或更高版本。 ColdFusion 5 中\n不支持 CFC。
CFC 旨在为开发人员\n封装其网站元素提供一种简单而强大的方法。一般来说，您应该\n将组件用于应用程序或商业逻辑。将自定义标记用于呈现元素，如自定义问候语、动态菜单等。
与许多其他类型的构造一样，动态地点通常可以\n受益于可互换的部件。例如，动态网站可能重复运行相同的查询，或计算购物车页面的总价格，并在每次添加商品时重新计算。这些任务可由组件来完成。 您可以修复、改进、\n扩展甚至替换组件，而对应用程序其余部分的影响极小。
假设网络商店基于订单价格计算运费。对于 20 美元以下的订单，运费为 4 美元；对于 20 美元到 40 美元之间的订单，运费为 6 美元，依此类推。您可以在购物车页面和结账页面中插入计算运费的逻辑，但这会\n混合 HTML 表示代码和 CFML 逻辑代码，通常会使\n代码难以维护和重用。
您决定创建一个名为 Pricing 的 CFC，其中包含一个名为 ShippingCharge 的函数。该功能\n将价格作为参数并返回运费。例如，如果参数的值为 32.80，该功能将返回\n6。
在购物车页面和结账页面中，您插入一个特殊标记来调用 ShippingCharge 函数。当请求页面时，将调用该功能并将运费\n返回到页面。
后来，网络商店宣布特别促销：100 美元以上的所有订购\n免费。您只需在一个地方更改运费——Pricing 组件的 ShippingCharge 函数——使用该函数的所有页面都会自动获得准确的运费。
组件面板概述 (ColdFusion)
使用"组件"面板（窗口 >\n组件）查看和编辑 ColdFusion 组件，并在页面中添加\n在请求 CFM 页面时调用该功能的代码。
注释
"组件"面板仅在 Dreamweaver 中查看 ColdFusion 页面\n时可用。
在 Dreamweaver 中创建或删除 CFC
您可以使用 Dreamweaver 以可视化方式定义 CFC 及其函数。 Dreamweaver 会创建 .cfc 文档并为您插入必要的 CFML 标记。
注释
根据组件的不同，您可能需要手动完成某些代码。
在组件面板（"窗口">"组件"）中，从弹出式菜单中选择"CF 组件"。
\n
单击加号 (+) 按钮，填写"创建组件"对话框，然后单击"确定"。
\n
a. 在“组件”部分输入组件的详细信息。 下面列出了部分列表：
名称 指定组件的文件名。 该名称只能包含字母数字字符和下划线 (_)。 输入名称时不要指定 .cfc 文件扩展名。
组件目录 指定将要保存组件的位置。 选择 Web 应用程序的根文件夹（如 \Inetpub\wwwroot\myapp\）或它的任何子文件夹。
b. 要为组件定义一个或多个功能，从"部分"列表中选择"功能"，单击加号 (+) 按钮，并输入新功能的详细信息。
确保在“返回值类型”选项中指定该函数返回的值的类型。
注释
如果您从“访问”菜单中选择“远程”，则该函数可用作 Web 服务。
c. 要为功能定义一个或多个参数，从"部分"列表中选择\n"参数"，从弹出式\n菜单中选择功能，单击加号 (+) 按钮，并在右侧输入新\n参数的详细信息。
如果您使用远程开发服务器，请将 CFC 文件和所有相关文件（例如用于实施功能或包含文件）上载到远程服务器。
\n
上载这些文件可确保 Dreamweaver 功能\n（如实时视图和"在浏览器中预览"）正常运行。
Dreamweaver 会写入一个 CFC 文件并将其保存\n在您指定的文件夹中。新组件也会出现在\n组件面板中（单击"刷新"后）。
如果您使用远程开发服务器，请将 CFC 文件和所有相关文件（例如用于实施功能或包含文件）上载到远程服务器。
\n
在 Dreamweaver 中查看 CFC
Dreamweaver 提供了一种方法，可用来以可视化方式对站点文件夹中或服务器上的 ColdFusion 组件 (CFC) 进行总体检查。 Dreamweaver 会读取 CFC 文件并在组件面板中以易于导航的树状视图显示有关这些文件的信息。
Dreamweaver 会在您的测试服务器上查找组件（请参阅在 Dreamweaver 中连接到数据库）。如果创建 CFC 或对现有 CFC 进行更改，请确保将 CFC 文件上传到测试服务器，以便这些文件能在“组件”面板中准确地反映出来。
若要查看位于其它服务器的组件，请更改测试服务器的设置。
您可以查看有关 CF 组件的下列任何信息：
列出服务器上定义的所有 ColdFusion 组件。
如果运行的是 ColdFusion MX 7 或更高版本，则过滤该列表以便仅显示位于您的站点文件夹中的 CFC。
了解每个组件的函数和参数。
检查用作 Web 服务的函数的属性。
注释
若要使用 Dreamweaver 检查驻留在服务器根目录中的 CFC，同时还要管理不同网站根目录中的站点文件，可以定义两个 Dreamweaver 站点。 将第一个站点设置为指向服务器根目录，将第二个站点设置为指向网站根目录。 使用“文件”面板上的站点弹出菜单可在这两个站点之间快速切换。
若要在 Dreamweaver 中查看 CFC，请按照以下步骤操作：
在 Dreamweaver 中打开任意 ColdFusion 页。
在组件面板（"窗口">"组件"）中，\n从弹出式菜单中选择"CF 组件"。
单击面板中的"刷新"按钮以检索\n组件。
将显示服务器上的组件包。 组件包是包含 CFC 文件的文件夹。
如果现有的\n组件包未出现，请单击面板\n工具栏中的"刷新"按钮。
要仅显示位于您的地点文件夹中的 CFC，\n请单击组件\n面板工具栏中的"仅显示当前地点的 CFC"按钮。
注释
此功能仅在您已将运行 ColdFusion MX 6 或更高版本的计算机\n定义为 Dreamweaver 的测试服务器时才可用。
注释
如果当前网站在远程服务器的虚拟文件夹中列出，则筛选不起作用。
单击包名称旁边的加号 (+) 按钮以查看存储在包中的组件。
要列出组件的功能，请单击\n组件名称旁边的加号 (+) 按钮。
要查看函数接受的参数以及参数的类型和它们是必需的还是可选的，请在树状视图中打开函数的分支。
不接受\n参数的功能旁边没有加号 (+) 按钮。
要快速查看参数、功能、\n组件或包的详细信息，请在树状视图中选择项目，然后\n单击面板工具栏中的"获取详细信息"按钮。
您还可以\n右键单击（Windows）或按住 Control 键单击（Macintosh）项目，\n然后从弹出式菜单中选择"获取详细信息"。
有关该项目的详细信息将显示在消息框中。
在 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\n在插入点将代码插入页面中。
如果您插入的函数有参数，请手动完成\n参数代码。
有关更多信息，请参阅 Dreamweaver 中的 ColdFusion 文档\n（帮助 >\n使用 ColdFusion）。
保存\n页面（文件 > 保存）。
在 CFC 中定义记录集
Dreamweaver 可以帮助您在 ColdFusion 组件 (CFC) 中定义记录集（也称为 ColdFusion 查询）。 通过在 CFC 中定义记录集，则无需在使用该记录集的每个页面上都进行定义。 在 CFC 中定义记录集一次，即可在不同页面上使用该 CFC。
注释
只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时，才能使用此功能。 有关详细信息，请参阅启用 ColdFusion 增强功能。
在 Dreamweaver 中创建 CFC 文件或打开现有的 CFC 文件。
在"绑定"面板（窗口 > 绑定）中，\n单击加号 (+) 按钮，然后从\n弹出菜单中选择"记录集（问题）"。
出现“记录集”对话框。 您可以在\n简单或高级记录集对话框中工作。
要在 CFC 中使用现有函数，请从"函数"弹出菜单中选择该函数，\n然后跳至步骤 5。
记录集是在函数中定义的。
要在 CFC 中定义新函数，请单击"新建函数"\n按钮，在出现的对话框中输入函数名称，\n然后单击"确定"。
名称只能包含字母数字字符和\n下划线 (_)。
要为该函数定义记录集，请完成\n"记录集"对话框选项。
新函数将插入到定义记录集的 CFC 中。
将 CFC 记录集用作动态内容的来源
如果某个 ColdFusion 组件 (CFC) 包含定义记录集的函数，则可以将该组件用作页面的动态内容源。
注释
只有您对运行 ColdFusion MX 7 或更高版本的计算机具有访问权限时，才能使用此功能。 有关详细信息，请参阅“启用 ColdFusion 增强功能”。
在 Dreamweaver 中打开一个 ColdFusion 页。
在"绑定"面板（窗口 > 绑定）中，\n单击加号 (+) 按钮，然后从\n弹出菜单中选择"记录集（问题）"。
出现“记录集”对话框。 您可以在\n简单或高级记录集对话框中工作。
单击“CFC 查询”按钮。
完成 CFC 问题对话框，单击"确定"，然后\n再次单击"确定"，将 CFC 记录集添加到"绑定"面板中可用\n内容来源列表。
使用"绑定"面板将记录集绑定到各种\n页面元素。
有关更多信息，请参阅向页面添加动态内容。
通过使用 CFC 定义动态内容
您可以通过使用包含记录集定义的 CFC，在 Dreamweaver 中将记录集定义为动态内容的来源。
1.在"名称"框中，输入 CFC 记录集的名称。
常见做法是在记录集名称前添加前缀 rs，以便将它们与代码中的其他对象名称区别开来，例如：rsPressRelease。
记录集名称只能包含字母数字字符和下划线 (_)。 不能使用特殊字符或空格。
2.从服务器上已定义的包中选择一个。
如果该包未出现在弹出菜单中，则可以通过单击弹出菜单附近的“刷新”按钮来刷新包的列表。
确保首先将 CFC 上传到测试服务器。 只有测试服务器上的 CFC 才能被显示出来。
3.从当前选定包中定义的组件中选择一个组件。
如果“组件”弹出菜单不包含任何组件，或者您以前创建的任何组件都没有出现在该菜单中，应将 CFC 文件上传到测试服务器。
4.（可选）要创建组件，请单击"创建新组件"按钮。
a. 在“名称”框中，输入新 CFC 的名称。 该名称只能包含字母数字字符和下划线 (_)。
b.在"组件目录"框中，输入 CFC 的位置，或者浏览以找到文件夹。
注释
文件夹必须为站点根文件夹的相对路径。
5.从"功能"弹出菜单中，选择包含记录集定义的功能。
“函数”弹出菜单仅包含当前选定组件中定义的函数。 如果没有任何函数出现在此弹出菜单中，或是如果您最近的更改未反映在当前列出的函数中，请检查是否已将最近的更改保存并上传到了服务器。
注释
“连接”和“SQL”框是只读的。
6.通过单击"编辑"按钮，编辑必须作为功能参数传递的每个参数（类型、值和默认值）。
a. 为当前参数输入一个值，方法是从“值”弹出菜单中选择值类型并在右侧的框中输入值。 值类型可以为 URL 参数、表单变量、Cookie、会话变量、应用程序变量或输入的值。
b. 在“默认值”框中输入该参数的默认值。 如果未返回任何运行时值，则使用该默认参数值。
c.单击"确定"。
您不能修改记录集的数据库连接和 SQL 查询。 这些字段始终处于禁用状态 -- 连接和 SQL 查询仅为提供信息而显示。
7.单击"测试"以连接到数据库并创建记录集的实例。
如果 SQL 语句包含页参数，则在单击“测试”前，请确保“参数”框的“默认值”列包含有效的测试值。
如果查询执行成功，则会有一个表显示该记录集。 每行包含一条记录，而每列表示该记录中的一个域。
单击“确定”清除 CFC 查询。
8.单击"确定"。
