用户界面已经在 Dreamweaver 和更高版本中做了简化。 因此,您可能在 Dreamweaver 和更高版本中找不到本文中描述的一些选项。 有关详细信息,请参阅此文章。
无需编写 SQL 即可定义记录集
您可以创建记录集\n而无需手动输入 SQL 语句。
出现简单的“记录集”对话框。 如果您正在开发\nColdFusion 地点,则"记录集"对话框会略有不同。\n(如果出现高级"记录集"对话框,请单击"简单"\n按钮以切换到简单"记录集"对话框。)
有关说明,请参见下列主题。
如果您定义了使用用户输入参数的筛选条件,\n请在"测试值"框中输入一个值,然后单击"确定"。如果成功创建了记录集的实例,将出现一个显示从记录集中提取的数据的表格。
简单记录集对话框的选项(PHP、ASP)
在"名称"框中,为\n记录集输入名称。
常见做法是在记录集名称前添加前缀 rs,以将它们与代码中的其他对象名称区分开来,例如:rsPressReleases。
记录集名称只能包含字母、数字和下划线字符 (_)。不能使用特殊字符或空格。
从“连接”弹出菜单中选择一个连接。
如果\n列表中未出现连接,请单击"定义"以创建连接。
在"表格"弹出菜单中,选择将为\n记录集提供数据的数据库表格。
弹出菜单显示\n指定数据库中的所有表格。
要在记录集中包含表格列的子集,\n请单击"选定",然后通过按住 Ctrl 单击\n(Windows)或按住 Command 单击(Macintosh)从列表中选择所需的列。
要进一步限制从表格\n返回的记录,请完成"筛选条件"部分:
从第一个弹出菜单中,选择数据库表中的一列以与您定义的测试值进行比较。
从第二个弹出菜单中,选择一个条件表达式,以将每个记录中的选定值与测试值进行比较。
在第三个弹出菜单中选择“输入的值”。
在框中输入测试值。
如果记录中的指定值符合您的筛选条件,则该记录将包含在记录集中。
(可选)要对记录排序,请选择要排序的列,然后指定记录是否应按升序排列(1、2、3...或 A、B、C...)或降序排列。
单击"测试"连接到数据库并创建数据源的实例,然后单击"确定"关闭数据源。
此时将显示一个表格,其中显示返回的数据。每行包含一条记录,每列代表该记录中的一个字段。
单击“确定”。 新定义的记录集将显示在"绑定"面板中。
简单记录集对话框的选项(ColdFusion)
为 ColdFusion 文档类型定义记录集作为动态内容的来源,无需手动编写 SQL 语句。
在"名称"框中,输入记录集的名称。
常见做法是在记录集名称中添加前缀 rs,以便在代码中将其与其他对象名称区分开来。例如:rsPressReleases
记录集名称只能包含字母、数字和下划线字符 (_)。不能使用特殊字符或空格。
如果您要为 ColdFusion 组件定义记录集(即,如果 CFC 文件当前在 Dreamweaver 中打开),请从"功能"弹出式菜单中选择现有的 CFC 功能,或者单击"新建功能"按钮创建新功能。
"功能"弹出式菜单仅在 CFC 文件为当前文档且您可以访问运行 ColdFusion MX 7 或更高版本的计算机时才可用。
记录集在函数中定义。
从“数据源”弹出菜单中选择数据源。
如果弹出菜单中未显示数据源,您必须创建一个 ColdFusion 数据源。
在"用户名"和"密码"框中,如果需要,请输入 ColdFusion 应用程序服务器的用户名和\n密码。
ColdFusion 中的数据源可能需要用户名和密码才能访问。如果您没有访问 ColdFusion 中数据源的用户名和密码,请联系您组织的 ColdFusion 管理员。
在"表"弹出菜单中,选择将为记录集提供数据的数据库表。
表格弹出菜单\n显示指定数据库中的所有表格。
若要在记录集中包含表格列的子集,\n请单击"选定"并通过按住 Control 键单击\n(Windows) 或按住 Command 键单击 (Macintosh) 在列表中选择所需的列。
若要进一步限制从表格返回的记录,请完成\n筛选条件部分:
从第一个弹出菜单中,选择数据库表中的一列,以与您定义的测试值进行比较。
从第二个弹出菜单中,选择条件表达式,将每条记录中的选定值与测试值进行比较。
在第三个弹出菜单中选择“输入的值”。
在框中输入测试值。
如果记录中的指定值满足您的筛选条件,该记录将包含在记录集中。
(可选) 若要对记录进行排序,请选择要排序的列,\n然后指定是否应按升序对记录进行排序\n(1、2、3...或 A、B、C...)或按降序排列。
单击"测试"连接到数据库并创建数据源的安装实例。
此时将显示一个表格,其中包含返回的数据。每行包含一个记录,每列代表该记录中的一个字段。单击“确定”关闭测试记录集。
单击“确定”。 新定义的 ColdFusion 记录集将显示在"绑定"面板中。
通过编写 SQL 定义高级记录集
使用高级记录集对话框编写您自己的 SQL 语句,或使用图形化数据库项目树创建 SQL 语句。
出现高级“记录集”对话框。 如果您正在开发 ColdFusion 地点,"记录集"对话框会略有不同。(如果出现简单记录集对话框,请单击"高级"按钮切换到高级记录集对话框。)
有关说明,请参见下列主题。
如果您定义了使用用户输入参数的筛选条件,"测试"按钮将显示"测试值"对话框。在"测试值"框中输入 1 个值并单击"确定"。如果成功创建了记录集实例,将显示包含记录集数据的表格。
高级记录集对话框的选项(PHP、ASP)
通过编写自定义 SQL 语句或使用图形化数据库项目树创建 SQL 语句,将记录集定义为动态内容的来源。
常见做法是在记录集名称中添加前缀 rs,以便在代码中将其与其他对象名称区分开来。例如:rsPressRelease。
记录集名称只能包含字母、数字和下划线字符 (_)。不能使用特殊字符或空格。
执行以下操作以使用数据库项目树构建 SQL 语句:
确保 SQL 文本区域为空。
展开树形结构的分支,直到找到所需的数据库对象,例如表中的列或数据库中的存储过程。
选择数据库对象,然后单击树形结构右侧的其中一个按钮。
例如,如果选择表列,可用的按钮包括 SELECT、WHERE 和 ORDER BY。单击其中一个按钮可将关联的子句添加到您的 SQL 语句中。
您还可以通过从数据库项目树中选择存储过程\n并单击"过程"按钮来使用存储过程中的预定义 SQL\n 语句。Dreamweaver 会自动填写 SQL 和变量区域。
在 PHP 中的 SQL 语句中使用变量时,Dreamweaver 会自动在变量名称前添加美元符号,因此您应该省略美元符号(例如,使用 colname 而不是 $colname)。
如果 SQL 语句包含变量,请确保变量框的默认值列包含有效的测试值。
运行时值通常是用户在 HTML 表单字段中输入的 URL 或表单参数。
运行时值列中的 URL 参数:
|
服务器模型 |
URL 参数的运行时值表达式 |
|
ASP |
Request.QueryString(“formFieldName”) |
|
PHP |
$_GET['formFieldName'] |
“运行时值”列中的表单参数:
|
服务器模型 |
表单参数的运行时值表达式 |
|
ASP |
Request.Form(“formFieldName”) |
|
PHP |
$_POST['formFieldName'] |
如果 SQL 语句包含变量,请确保在单击"测试"之前"变量"框的"默认值"列包含有效的测试值。
如果成功,将显示一个表格,其中显示您记录集中的数据。每一行包含一条记录,每一列代表该记录中的一个字段。单击"确定"以清除记录集。
高级记录集对话框的选项 (ColdFusion)
使用高级记录集对话框编写自定义 SQL 查询,或使用数据库项目树通过点选界面创建 SQL 查询。
常见的做法是在记录集名称中添加前缀 rs,以便将它们与代码中的其他对象名称区分开来。例如:rsPressReleases
记录集名称只能包含字母、数字和下划线字符 (_)。不能使用特殊字符或空格。
如果您要为 ColdFusion 组件定义记录集(即,如果当前在 Dreamweaver 中打开了 CFC 文件),请从"功能"弹出菜单中选择现有的 CFC 功能,或单击"新建功能"按钮创建新功能。
只有在 CFC 文件是当前文档且您有权访问运行 ColdFusion MX 7 或更高版本的计算机时,"功能"弹出菜单才可用。
记录集在函数中定义。
如果弹出菜单列表中未显示任何数据源,您需要先创建 ColdFusion 数据源。
ColdFusion 中的数据源可能需要用户名和密码才能访问。如果您没有访问 ColdFusion 中数据源的用户名和密码,请联系您组织的 ColdFusion 管理员。
确保 SQL 文本区域为空。
展开树的分支,直到找到您需要的数据库对象,例如表中的列。
选择数据库对象并单击树右侧的按钮之一。
例如,如果您选择表列,可用按钮为"选择"、"Where"和"Order By"。单击其中一个按钮,将关联的子句添加到您的 SQL 语句中。
如果您的 SQL 语句包含参数,请通过单击加号(+)按钮并输入参数的名称和默认值(如果未返回运行时值,参数应采用的值)在"参数"区域中定义其值。
如果 SQL 语句包含参数,请确保"参数"框的"默认值"列包含有效的测试值。
页面参数允许您为编写的 SQL 中的运行时值引用提供默认值。例如,以下 SQL 语句根据员工 ID 的值选择员工记录。您可以为此参数分配默认值,确保始终返回运行时值。在此示例中,FormFieldName 指用户输入员工 ID 的表单字段:
SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))
添加页面参数对话框将包含类似于以下内容的名称-值配对:
|
名称 |
默认值 |
|
FormFieldName |
0001 |
运行时值通常是用户在 HTML 表单字段中输入的 URL 或表单参数。
如果 SQL 语句包含运行时引用,请确保在单击"测试"之前,"页面参数"字段的"默认值"列包含有效的测试值。
如果成功,将显示一个表格,显示记录集中的数据。每行包含一条记录,每列表示该记录中的一个字段。单击"确定"以清除记录集。
在 SQL 语句中定义参数 (ColdFusion)
在 SQL 语句中定义参数;默认值是如果未返回运行时值时参数应使用的值。
在 SQL 语句中定义参数\n(PHP)
在 SQL 语句中定义参数;默认值是当没有返回运行时值时参数应使用的值。
使用"数据库项"树创建 SQL 查询
您可以使用"数据库项"的点选界面创建复杂的 SQL 查询,而无需手动在 SQL 框中输入 SQL 语句。"数据库项"树允许您选择数据库对象,并使用 SQL SELECT、WHERE 和 ORDER BY 子句将它们关联起来。创建 SQL 查询后,您可以使用对话框的"变量"区域定义任何变量。
接下来的两个示例描述了两个 SQL 语句以及使用高级记录集对话框的"数据库项"树创建它们的步骤。
示例: 选择表
此示例选择 Employees 表的全部内容。定义查询的 SQL 语句如下所示:
SELECT * FROM Employees
要创建此查询,请按照以下步骤操作。
示例:从表中选择特定行并对结果进行排序
以下示例从 Employees 表中选择两行记录,并使用您必须定义的变量选择作业类型。然后,按雇员姓名对结果进行排序。
SELECT emplNo, emplName
FROM Employees
WHERE emplJob = 'varJob'
ORDER BY emplName
选择 emplNo,然后单击\n"选择"按钮。
选择 emplName,然后单击\n"选择"按钮。
选择 emplJob, 然后单击"Where"\n按钮。
选择 emplName,然后单击\n"排序"按钮。
定义 URL 参数
URL 参数存储用户输入的检索信息。开始之前,请确保向服务器传递表单或 URL 参数。定义 URL 变量后,您可以在当前选定的页面中使用其值。
|
文档类型 |
绑定面板中用于 URL 变量的菜单项 |
|
ASP |
请求变量 > Request.QueryString |
|
ColdFusion |
URL 变量 |
|
PHP |
URL 变量 |
URL 变量名称通常是用于获取其值的 HTML 表单字段或对象的名称。
定义表单参数
表单参数存储包含在网页 HTTP 请求中的检索信息。如果您创建\n一个使用 POST 方法的表单,则表单提交的数据\n将传递到服务器。在开始之前,请确保\n将表单参数传递到服务器。将表单\n参数定义为内容来源后,您可以在页面中使用其值。
|
文档类型 |
“绑定”面板中用于表单变量的菜单项 |
|
ASP |
请求变量 > Request.Form |
|
ColdFusion |
表单变量 |
|
PHP |
表单变量 |
表单参数即会出现在“绑定”面板中。
定义会话变量
您可以使用会话变量来存储\n和显示在用户访问(或会话)期间维护的信息。服务器为\n每个用户创建不同的会话对象,并将其维护一段设定的时间,或直到\n明确终止该对象。
为页面定义会话变量之前,您必须在源代码中创建它们。在 Web 应用程序的源代码中创建会话变量后,您可以使用 Dreamweaver 检索其值并在网页中使用。
例如,此 ColdFusion 示例实例化一个名为 username 的会话,并为其分配值 Cornelius:
<CFSET session.username = Cornelius>
为 ASP 和 ColdFusion 定义应用程序变量
在 ASP 和 ColdFusion 中,您可以使用应用程序变量来存储和显示在应用程序存留期内维护并在用户间持续存在的信息。定义应用程序变量后,您可以在页面中使用其值。
PHP 中没有应用程序变量对象。
应用程序变量会显示在"绑定"面板中"应用程序"图标下。
使用变量作为 ColdFusion 记录集的数据源
当您在"绑定"面板中为页面定义记录集时,Dreamweaver 会在页面上的 cfquery 标记中输入 ColdFusion 数据源的名称。为了获得更大的灵活性,您可以将数据源名称存储在变量中,然后在 cfquery 标记中使用该变量。Dreamweaver 提供了在记录集中指定此类变量的可视化方法。
出现“数据源名称变量”对话框。
在"记录集"对话框中,变量会与服务器上的 ColdFusion 数据源一起显示在"数据源"弹出菜单中。
Dreamweaver 不会为您初始化变量,因此您可以按照所需的方式和位置进行初始化。您可以在页面代码中(cfquery 标记之前)、包含文件中或其他某个文件中将变量初始化为会话或应用程序变量。
定义服务器变量
您可以定义服务器变量作为动态内容来源,以在 Web 应用程序中使用。服务器变量因文档类型而异,包括表单变量、URL 变量、会话变量和应用程序变量。
服务器变量可以被所有访问服务器的客户端以及在服务器上运行的任何应用程序访问。变量一直存在,直到服务器停止。
定义 ColdFusion 服务器变量
下表列出了内置的 ColdFusion 服务器变量:
|
变量 |
说明 |
|
Server.ColdFusion.ProductName |
ColdFusion 产品名。 |
|
Server.ColdFusion.ProductVersion |
ColdFusion 版本号。 |
|
Server.ColdFusion.ProductLevel |
ColdFusion 版本(企业版、专业版)。 |
|
Server.ColdFusion.SerialNumber |
当前安装的 ColdFusion 版本的序列号。 |
|
Server.OS.Name |
服务器上运行的操作系统名称(Windows XP、Windows 2000、Linux)。 |
|
Server.OS.AdditionalInformation |
关于已安装操作系统的附加信息(服务包、更新)。 |
|
Server.OS.Version |
已安装的操作系统的版本。 |
|
Server.OS.BuildNumber |
已安装的操作系统的版本号。 |
定义 ColdFusion 本地变量
本地变量是使用 CFSET 或 CFPARAM 标记在 ColdFusion 页面内创建的变量。定义的本地变量将显示在\n"绑定"面板中。
定义 ASP 服务器变量
您可以将以下 ASP 服务器变量定义为动态内容的来源:Request.Cookie、Request.QueryString、Request.Form、Request.ServerVariables 以及 Request.ClientCertificates。
QueryString 集合
检索附加到发送页面 URL 的信息,例如当页面包含使用 GET 方法的 HTML 表单时。查询字符串由一个或多个名称值对组成(例如 last=Smith、first=Winston),\n带有问号 (?) 附加到 URL 后。如果\n查询字符串包含多个名称值对,则用\n和号 (&) 将它们连接起来。
Form 集合
检索 HTML 表单通过 POST 方法包含在 HTTP 请求正文中的表单信息。
ServerVariables 集合
检索预定义环境变量的值。 该收藏集包含一长串变量,包括 CONTENT_LENGTH(HTTP 请求中提交的内容长度,您可以用它来查看表单是否为空)和 HTTP_USER_AGENT(提供有关用户浏览器的信息)。
例如,Request.ServerVariables(\"HTTP_USER_AGENT\") 包含\n有关提交浏览器的信息,例如 Mozilla/4.07\n[en] (WinNT; I),表示 Netscape Navigator 4.07\n浏览器。
有关 ASP 服务器环境变量的完整列表,\n请参阅随 Microsoft Personal Web\nServer (PWS) 或 Internet Information Server (IIS) 安装的在线文档。
Cookies 集合
检索在 HTTP 请求中发送的 Cookie 的值。 例如,假设页面在\n用户系统上读取名为"readMe"的 Cookie。在服务器上,Cookie 的值存储在变量 Request.Cookies("readMe") 中。
ClientCertificate 集合
检索浏览器发送的 HTTP 请求中的证书字段。证书字段在 X.509 标准中规定。
例如,如果您要访问 Request.ServerVariables("HTTP_USER_AGENT") 变量中的信息,请输入参数 HTTP_USER_AGENT。如果您要访问 Request.Form("lastname") 变量中的信息,请输入参数 lastname。
请求变量显示在"绑定"面板中。
定义 PHP 服务器变量
将服务器变量定义为 PHP 页面的动态内容来源。PHP 服务器变量显示在"绑定"面板中。
有关更多信息,请在 PHP 文档中搜索关键词 $_SERVER。
定义 ColdFusion 客户端变量
将 ColdFusion 客户端变量定义为页面\n动态内容的来源。新定义的 ColdFusion 客户端\n变量显示在"绑定"面板中。
例如,要访问 Client.LastVisit ColdFusion 变量中的信息,\n请输入 LastVisit。
客户端变量是\n在代码中创建的变量,用于将数据与特定客户端关联。\n客户端变量在用户从应用程序内的一个页面移动到另一个页面时,以及从一个会话移动到另一个会话时,维护应用程序的状态。
客户端变量可以是用户定义的也可以是内置的。 下表列出了内置的 ColdFusion 客户端变量:
|
变量 |
说明 |
|
Client.CFID |
连接到服务器的每个客户端的增量 ID。 |
|
Client.CFTOKEN |
用于唯一标识特定客户端的\n随机生成数字。 |
|
Client.URLToken |
当不使用 Cookie 时在模板之间\n传递的 CFID 和 CFTOKEN 的组合。 |
|
Client.LastVisit |
记录客户端上次访问的\n时间戳。 |
|
Client.HitCount |
与单个客户端关联的页面请求数\n(使用 CFID 和 CFTOKEN 跟踪)。 |
|
Client.TimeCreated |
记录为特定客户端首次创建\nCFID 和 CFTOKEN 时的时间戳。 |
定义 ColdFusion Cookie 变量
Cookie 变量在代码中创建,\n并访问浏览器传递给服务器的 Cookie 中包含的信息。定义的 Cookie 变量出现在"绑定"\n面板中。
定义 ColdFusion CGI 变量
定义的 CGI 变量出现在"绑定"\n面板中。
例如,如果您想访问 CGI.HTTP_REFERER 变量中的信息,请输入 HTTP_REFERER。
下表列出了在服务器上创建的最常见的 ColdFusion CGI 变量:
变量 |
说明 |
|---|---|
SERVER_SOFTWARE |
响应请求(并运行网关)的信息\n服务器软件的名称和版本。\n格式: name/version. |
SERVER_NAME |
服务器的主机名、DNS 别名或 IP\n地址(如自引用 URL 中显示的那样)。 |
GATEWAY_INTERFACE |
此服务器符合的 CGI 规范的修订版本。格式: CGI/修订版。 |
SERVER_PROTOCOL |
此请求附带的信息协议的名称和修订版本。格式: 协议/修订版。 |
SERVER_PORT |
请求发送到的端口号。 |
REQUEST_METHOD |
发送该请求时使用的方法。 对于 HTTP,即为 Get、Head、Post 等。 |
PATH_INFO |
客户端提供的额外路径信息。脚本可以通过其虚拟路径名进行访问,\n在此路径末尾附加额外信息。额外信息\n作为 PATH_INFO 发送。 |
PATH_TRANSLATED |
服务器提供 PATH_INFO 的翻译版本,该版本获取路径并对其执行从虚拟到物理的映射。 |
SCRIPT_NAME |
正在执行的脚本的虚拟路径;\n用于自引用 URL。 |
QUERY_STRING |
问号 (?) 后面的查询信息查询信息。 |
REMOTE_HOST |
发送请求的主机名。 如果服务器没有此信息,则设置 REMOTE_ADDR 而不设置 REMOTE_HOST。 |
REMOTE_ADDR |
发出请求的远程主机的 IP 地址。 |
AUTH_TYPE |
如果服务器支持用户身份验证,\n并且脚本受保护,则这是用于验证用户的特定于协议的身份验证\n方法。 |
REMOTE_USER AUTH_USER |
如果服务器支持用户身份验证,\n并且脚本受保护,则这是它们已身份验证\n的用户名。(也可用作 AUTH_USER。) |
REMOTE_IDENT |
如果 HTTP 服务器支持 RFC 931 标识,此变量将设置为从服务器检索的远程用户名。此变量仅用于日志记录。 |
CONTENT_TYPE |
对于具有附加信息的查询(例如 HTTP POST 和 PUT),这是数据的内容类型。 |
CONTENT_LENGTH |
客户端提供的内容长度。 |
下表列出了浏览器创建并传递给服务器的最常见\nCGI 变量:
|
变量 |
说明 |
|
HTTP_REFERER |
引用文档。 这是链接到或提交表单数据的文档。 |
|
HTTP_USER_AGENT |
客户端当前用于发送请求的浏览器。格式: 软件/版本 库/版本。 |
|
HTTP_IF_MODIFIED_SINCE |
最后一次修改页面的时间。 此变量由浏览器自行决定发送,通常是响应服务器发送的 LAST_MODIFIED HTTP 标头。它可用于利用浏览器端缓存。 |
缓存内容源
您可以在设计注释中缓存或存储动态内容源。这样一来,即使您无法访问存储动态内容来源的数据库或应用程序服务器,也可以处理站点。缓存还可能通过避免重复跨网络访问数据库和应用程序服务器来加快开发速度。
如果您更改了其中一个内容来源,可以单击"绑定"面板右上角的"刷新"按钮(圆形箭头图标)来刷新缓存。(如果看不到按钮,请展开面板。)
更改或删除内容源
您可以更改或删除任何现有的动态内容来源,即"绑定"面板中列出的任何内容来源。
在"绑定"面板中更改或删除内容来源不会更改或删除页面上该内容的任何实例。它只是将其作为页面可能的内容来源进行更改或删除。
在"绑定"面板中更改内容来源
从"绑定"面板删除内容来源
将记录集从一个页面复制到另一个页面
您可以在已定义的网站内将记录集从一个页面复制到另一个页面。