在 Adobe Dreamweaver 中定义动态内容源

优质
小牛编辑
165浏览
2023-12-01

注意:用户界面已经在 Dreamweaver CC 和更高版本中做了简化。因此,您可能在 Dreamweaver CC 和更高版本中找不到本文中描述的一些选项。有关详细信息,请参阅此文章。

不通过编写 SQL 来定义记录集

您不需要手动输入 SQL 语句就可以创建记录集。

  1. 在“文档”窗口中打开要使用记录集的页面。
  2. 选择“窗口”>“绑定”以显示“绑定”面板。
  3. 在“绑定”面板中,单击加号 (+) 按钮并从弹出菜单中选择“记录集(查询)”。

    出现简单的“记录集”对话框。如果开发的是 ColdFusion 站点,则该“记录集”对话框略有不同。(如果出现的是高级的“记录集”对话框,请单击“简单”按钮切换到简单的“记录集”对话框。)

  4. 针对您的文档类型完成“记录集”对话框。

    有关说明,请参见下列主题。

  5. 单击“测试”按钮执行查询,并确保该查询检索到自己想要的信息。

    如果定义了使用用户输入的参数的过滤器,则在“测试值”框中输入一个值,然后单击“确定”。记录集实例成功创建时,将出现一个显示从该记录集中提取的数据的表格。

  6. 单击“确定”将该记录集添加到“绑定”面板的可用内容源列表中。

简单记录集对话框选项(PHP、ASP)

  1. 在“名称”框中,输入记录集的名称。

    通常的做法是在记录集名称前添加前缀 rs,以将其与代码中的其它对象名称区分开,例如:rsPressReleases。

    记录集名称只能包含字母、数字和下划线 (_)。不能使用特殊字符或空格。

  2. 从“连接”弹出菜单中选择一个连接。

    如果列表中未出现连接,请单击“定义”创建连接。

  3. 在“表”弹出菜单中,选择为记录集提供数据的数据库表。

    弹出菜单显示指定数据库中的所有表。

  4. 若要在记录集中包含表列的子集,请单击“已选定”,然后按住 Ctrl 单击 (Windows) 或按住 Command 单击 (Macintosh) 表中的列,以选择所需列。
  5. 若要进一步限制从表中返回的记录,请完成“过滤器”部分:

    • 在第一个弹出菜单中,选择数据库表中的列,以将其与定义的测试值进行比较。
    • 从第二个弹出菜单中选择一个条件表达式,以便将每个记录中的选定值与测试值进行比较。
    • 在第三个弹出菜单中选择“输入的值”。
    • 在框中输入测试值。

      如果记录中的指定值符合筛选条件,则将该记录包括在记录集中。

  6. (可选)若要对记录进行排序,请选择要作为排序依据的列,然后指定是按升序(1、2、3... 或 A、B、C...)还是按降序对记录进行排序。
  7. 单击“测试”连接到数据库并创建数据源实例,然后单击“确定”关闭数据源。

    出现显示返回数据的表格。每行包含一条记录,而每列表示该记录中的一个域。

  8. 单击“确定”。新定义的记录集即会出现在“绑定”面板中。

简单记录集对话框选项 (ColdFusion)

将用于 ColdFusion 文档类型的记录集定义为动态内容源,而无须手动编写 SQL 语句代码。

  1. 在“名称”框中,输入记录集的名称。

    通常的做法是在记录集名称前添加前缀 rs,以将其与代码中的其它对象名称区分开。例如:rsPressReleases

    记录集名称只能包含字母、数字和下划线 (_)。不能使用特殊字符或空格。

  2. 如果要定义用于 ColdFusion 组件的记录集(即,如果当前在 Dreamweaver 中打开 CFC 文件),请从“函数”弹出菜单中选择一个现有的 CFC 函数,或单击“新函数”按钮来创建一个新函数。

    注意:仅在当前文档为 CFC 文件且您有权访问运行 ColdFusion MX 7 或更高版本的计算机时,才可以使用“函数”弹出菜单。

    记录集是在函数中定义的。

  3. 从“数据源”弹出菜单中选择数据源。

    如果弹出菜单中未出现数据源,则必须创建 ColdFusion 数据源。

  4. 如果需要,在“用户名”和“密码”框中,输入 ColdFusion 应用程序服务器的用户名和密码。

    访问 ColdFusion 中的数据源时可能需要用户名和密码。如果您没有访问 ColdFusion 中的数据源所需的用户名和密码,请与组织的 ColdFusion 管理员联系。

  5. 在“表”弹出菜单中,选择为记录集提供数据的数据库表。

    “表”弹出菜单显示指定数据库中的所有表。

  6. 若要在记录集中包含表列的子集,请单击“已选定”,然后按住 Ctrl 单击 (Windows) 或按住 Command 单击 (Macintosh) 表中的列,以选择所需列。
  7. 若要进一步限制从表中返回的记录,请完成“过滤器”部分:

    • 在第一个弹出菜单中,选择数据库表中的列,以将其与定义的测试值进行比较。
    • 从第二个弹出菜单中选择一个条件表达式,以便将每个记录中的选定值与测试值进行比较。
    • 在第三个弹出菜单中选择“输入的值”。
    • 在框中输入测试值。

      如果记录中的指定值符合筛选条件,则该记录将包括在记录集中。

  8. (可选)若要对记录进行排序,请选择要作为排序依据的列,然后指定是按升序(1、2、3... 或 A、B、C...)还是按降序对记录进行排序。
  9. 单击“测试”连接到数据库并创建数据源实例。

    出现显示返回数据的表格。每行包含一条记录,而每列表示该记录中的一个域。单击“确定”关闭测试记录集。

  10. 单击“确定”。新定义的 ColdFusion 记录集即会出现在“绑定”面板中。

通过编写 SQL 来定义高级记录集

使用高级“记录集”对话框编写自己的 SQL 语句,或使用图形化“数据库项”树来创建 SQL 语句。

  1. 在“文档”窗口中打开要使用记录集的页面。
  2. 选择“窗口”>“绑定”以显示“绑定”面板。
  3. 在“绑定”面板中,单击加号 (+) 按钮并从弹出菜单中选择“记录集(查询)”。

    出现高级“记录集”对话框。如果开发的是 ColdFusion 站点,则该“记录集”对话框略有不同。(如果出现的是简单“记录集”对话框,则请通过单击“高级”按钮切换到高级“记录集”对话框。)

  4. 完成高级“记录集”对话框。

    有关说明,请参见下列主题。

  5. 单击“测试”按钮执行查询,并确保该查询检索到自己想要的信息。

    如果定义了使用用户输入的参数的过滤器,则单击“测试”按钮时将显示“测试值”对话框。在“测试值”框中输入一个值,然后单击“确定”。记录集实例成功创建时,将出现一个显示该记录集中数据的表格。

  6. 单击“确定”将该记录集添加到“绑定”面板的可用内容源列表中。

高级记录集对话框选项(PHP、ASP)

通过编写自定义 SQL 语句或使用图形化“数据库项”树来创建 SQL 语句,将记录集定义为动态内容源。

  1. 在“名称”框中,输入记录集的名称。

    通常的做法是在记录集名称前添加前缀 rs,以将其与代码中的其它对象名称区分开。例如:rsPressRelease。

    记录集名称只能包含字母、数字和下划线 (_)。不能使用特殊字符或空格。

  2. 从“连接”弹出菜单中选择一个连接。
  3. 在 SQL 文本区域中输入一个 SQL 语句,或使用对话框底部的图形化“数据库项”树从所选的记录集生成一个 SQL 语句。

    若要使用“数据库项”树生成 SQL 语句,请执行以下操作:

    • 确保 SQL 文本区域为空。
    • 展开树的分支直到找到所需的数据库对象,例如表中的列或数据库中的预存过程。
    • 选择该数据库对象并单击树右侧的按钮之一。

      例如,如果选择表列,则可用的按钮是“SELECT”、“WHERE”和“ORDER BY”。单击这些按钮之一将关联的子句添加到 SQL 语句中。

      您还可以使用在预存过程中预定义的 SQL 语句,方法是从“数据库项”树中选择该预存过程并单击“过程”按钮。Dreamweaver 将自动填充“SQL”和“变量”区域。

  4. 如果 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']

  5. 单击“测试”连接到数据库并创建一个记录集实例。

    如果 SQL 语句包含变量,则在单击“测试”前,请确保“变量”框的“默认值”列包含有效的测试值。

    如果成功,将出现一个显示记录集中数据的表格。每行包含一条记录,而每列表示该记录中的一个域。单击“确定”清除该记录集。

  6. 如果对所做的工作感到满意,请单击“确定”。

高级记录集对话框选项 (ColdFusion)

使用高级“记录集”对话框来编写自定义 SQL 查询,或在使用指向并单击界面时通过“数据库项”树来创建 SQL 查询。

  1. 在“名称”框中,输入记录集的名称。

    通常的做法是在记录集名称前添加前缀 rs,以将其与代码中的其它对象名称区分开。例如:rsPressReleases

    记录集名称只能包含字母、数字和下划线 (_)。不能使用特殊字符或空格。

    如果要定义用于 ColdFusion 组件的记录集(即,如果当前在 Dreamweaver 中打开 CFC 文件),请从“函数”弹出菜单中选择一个现有的 CFC 函数,或单击“新函数”按钮来创建一个新函数。

    注意:仅在当前文档为 CFC 文件且您有权访问运行 ColdFusion MX 7 或更高版本的计算机时,才可以使用“函数”弹出菜单。

    记录集是在函数中定义的。

  2. 从“数据源”弹出菜单中选择数据源。

    如果该弹出菜单列表中未出现数据源,则需要首先创建 ColdFusion 数据源。

  3. 如果需要,在“用户名”和“密码”框中,输入 ColdFusion 应用程序服务器的用户名和密码。

    访问 ColdFusion 中的数据源时可能需要用户名和密码。如果您没有访问 ColdFusion 中的数据源所需的用户名和密码,请与组织的 ColdFusion 管理员联系。

  4. 在 SQL 文本区域中输入一个 SQL 语句,或使用对话框底部的图形化“数据库项”树从所选的记录集生成一个 SQL 语句。
  5. (可选)若要使用“数据库项”树生成 SQL 语句,请执行以下操作:
    • 确保 SQL 文本区域为空。
    • 展开树的分支直到找到所需的数据库对象,例如表中的列。
    • 选择该数据库对象并单击树右侧的按钮之一。

    例如,如果选择表列,则可用的按钮是“SELECT”、“WHERE”和“ORDER BY”。单击这些按钮之一将关联的子句添加到 SQL 语句中。

    如果 SQL 语句包含参数,请在“参数”区域中定义它们的值,方法是单击加号 (+) 按钮并输入参数名称和默认值(在未返回运行时的参数取值)。

    如果 SQL 语句包含参数,请确保“参数”框的“默认值”列包含有效的测试值。

    使用“页面参数”可以为您编写的 SQL 中的运行时值引用提供默认值。例如,下面的 SQL 语句将根据雇员的 ID 值来选择一条雇员记录。您可以为此参数指定默认值,确保始终能返回运行时值。在本例中,FormFieldName 指的是用户可以在其中输入雇员 ID 的表单域:

    SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))

    “添加页面参数”对话框应包含一个与下面类似的名称/值对:

    名称

    默认值

    FormFieldName

    0001

    运行时值通常是用户在 HTML 表单域中输入的 URL 参数或表单参数。

  6. 单击“测试”连接到数据库并创建一个记录集实例。

    如果 SQL 语句包含运行时引用,则在单击“测试”前,请确保“页面参数”域的“默认值”列包含有效的测试值。

    如果成功,将出现一个显示记录集中数据的表格。每行包含一条记录,而每列表示该记录中的一个域。单击“确定”清除该记录集。

  7. 如果对所做的工作感到满意,请单击“确定”。

定义 SQL 语句中的参数 (ColdFusion)

定义 SQL 语句中的参数;默认值是该参数在未返回运行时值的情况下应使用的值。

  1. 从“名称”弹出菜单中选择一个参数名称。
  2. 在“默认参数”框中输入该参数的默认值,并单击“确定”。

定义 SQL 语句中的参数 (PHP)

定义 SQL 语句中的参数;默认值是该参数在未返回运行时值的情况下应使用的值。

  1. 在“名称”框中输入参数名称。
  2. 在“默认参数”框中输入该参数的默认值。
  3. 在“运行时值”框中输入参数的运行时值,并单击“确定”。

使用数据库项树创建 SQL 查询

可以使用“数据库项”的指向并单击界面创建复杂的 SQL 查询,而不必在 SQL 框中手动键入 SQL 语句。“数据库项”树使您可以选择数据库对象,并使用 SQL SELECT、WHERE 和 ORDER BY 子句链接它们。创建 SQL 查询后,即可使用对话框的“变量”区域定义任何变量。

以下两个示例描述了两个 SQL 语句以及使用高级“记录集”对话框的“数据库项”树创建它们的步骤。

示例: 选择表

本例选择 Employees 表的全部内容。定义查询的 SQL 语句如下所示:

SELECT * FROM Employees

若要创建此查询,请执行以下步骤。

  1. 展开 Tables 分支以显示所选数据库中的全部表。
  2. 选择 Employees 表。
  3. 单击“Select”按钮。
  4. 单击“确定”将记录集添加到“绑定”面板中。

示例: 从表中选择特定行并对结果进行排序

下例从 Employees 表中选择两行,并使用必须定义的变量选择职业类型。然后,按雇员姓名对结果进行排序。

SELECT emplNo, emplName FROM Employees WHERE emplJob = 'varJob' ORDER BY emplName
  1. 展开 Tables 分支以显示所选数据库中的所有表,然后展开 Employees 表以显示单独的表行。
  2. 按下列步骤生成 SQL 语句:
    • 选取 emplNo 并单击“Select”按钮。
    • 选取 emplName 并单击“Select”按钮。
    • 选取 emplJob, 并单击“Where”按钮。
    • 选取 emplName 并单击“Order By”按钮。
  3. 将插入点放在 SQL 文本区域中的 WHERE emplJob 后面,然后键入 ='varJob'(包括等号)。
  4. 定义变量 'varJob',方法为单击“变量”区域中的加号 (+) 按钮,然后在“名称”、“默认值”和“运行时值”列中分别输入下列值:varJob、CLERK 和 Request("job")。
  5. 单击“确定”将记录集添加到“绑定”面板中。

定义 URL 参数

URL 参数存储用户输入的检索信息。开始之前,请确保将表单或 URL 参数传递到服务器。定义 URL 变量后,即可在当前所选页面中使用其值。

  1. 在“文档”窗口中打开要使用该变量的页面。
  2. 选择“窗口”>“绑定”以显示“绑定”面板。
  3. 在“绑定”面板中单击加号 (+) 按钮,然后从弹出菜单中选择下列选项之一:

    文档类型

    绑定面板中用于 URL 变量的菜单项

    ASP

    请求变量 > Request.QueryString

    ColdFusion

    URL 变量

    PHP

    URL 变量

  4. 在“URL 变量”对话框的框中输入 URL 变量的名称,并单击“确定”。

    URL 变量的名称通常是用于获得变量值的 HTML 表单域或对象的名称。

  5. URL 变量即会出现在“绑定”面板中。

定义表单参数

表单参数存储包含在网页的 HTTP 请求中的检索信息。如果创建使用 POST 方法的表单,则通过该表单提交的数据将传递到服务器。开始之前,请确保将表单参数传递到服务器。将表单参数定义为内容源后,即可在页面中使用其值。

  1. 在“文档”窗口中打开要使用该变量的页面。
  2. 选择“窗口”>“绑定”以显示“绑定”面板。
  3. 在“绑定”面板中单击加号 (+) 按钮,然后从弹出菜单中选择下列选项之一:

    文档类型

    “绑定”面板中用于表单变量的菜单项

    ASP

    请求变量 > Request.Form

    ColdFusion

    表单变量

    PHP

    表单变量

  4. 在“表单变量”对话框中,输入该表单变量的名称,并单击“确定”。表单参数的名称通常是用于获得其值的 HTML 表单域或对象的名称。

    表单参数即会出现在“绑定”面板中。

    展开了表单的“绑定”面板

定义会话变量

可以使用会话变量来存储和显示在用户访问(或会话)期间保持的信息。服务器为每个用户创建不同的阶段对象并保持一段固定时间,或直至该对象被明确终止。

定义页面的会话变量之前,必须先在源代码中创建它们。在 Web 应用程序的源代码中创建会话变量后,即可使用 Dreamweaver 检索变量值并将其用于网页中。

  1. 在源代码中创建一个会话变量并为其指定值。

    例如,下面的 ColdFusion 示例实例化一个名为 username 的会话,并为其指定值 Cornelius:

    <CFSET session.username = Cornelius>
  2. 选择“窗口”>“绑定”显示“绑定”面板。
  3. 单击加号 (+) 按钮并从弹出菜单中选择“会话变量”。
  4. 输入应用程序源代码中定义的变量名称,并单击“确定”。

定义用于 ASP 和 ColdFusion 的应用程序变量

在 ASP 和 ColdFusion 中,可以使用应用程序变量来存储和显示某些信息,这些信息在应用程序的生存期内被保持并且在用户改变时仍持续存在。定义了应用程序变量后,就可以在页面中使用它的值。

注意:PHP 中没有应用程序变量对象。

  1. 在“文档”窗口中打开动态文档类型。
  2. 选择“窗口”>“绑定”显示“绑定”面板。
  3. 单击加号 (+) 按钮并从弹出菜单中选择“应用程序变量”。
  4. 输入应用程序源代码中定义的变量名称,并单击“确定”。

    应用程序变量即会出现在“应用程序”图标下的“绑定”面板中。

    展开了“应用程序”的“绑定”面板

使用变量作为 ColdFusion 记录集的数据源

在“绑定”面板中定义页面的记录集时,Dreamweaver 将在页面上的 cfquery 标签中输入 ColdFusion 数据源的名称。要获得更大的灵活性,可将数据源名称存储在一个变量中,并在 cfquery 标签中使用该变量。Dreamweaver 为在记录集中指定类似变量提供了一种可视化方法。

  1. 确保 ColdFusion 页在“文档”窗口中处于活动状态。
  2. 在“绑定”面板中,单击加号 (+) 按钮并从弹出菜单中选择“数据源名称变量”。

    出现“数据源名称变量”对话框。

  3. 定义一个变量,然后单击“确定”。
  4. 定义记录集时,请选择该变量作为记录集的数据源。

    在“记录集”对话框中,该变量与服务器上的 ColdFusion 数据源一起出现在“数据源”弹出菜单中。

  5. 完成“记录集”对话框设置,然后单击“确定”。
  6. 初始化变量。

    Dreamweaver 不会为您初始化变量,这样,您便可以按自己的需要对其进行初始化。您可以在页面代码中(cfquery 标签之前)、包含文件中或在某些其它文件中将该变量初始化为会话变量或应用程序变量。

定义服务器变量

您可以将服务器变量定义为动态内容源,以便在 Web 应用程序中使用。服务器变量因文档类型而异,其中包括表单变量、URL 变量、会话变量和应用程序变量。

所有访问该服务器的客户端以及在该服务器上运行的任何应用程序都可以访问服务器变量。这些变量将一直持续到服务器停止工作。

定义 ColdFusion 服务器变量

  1. 打开“绑定”面板(“窗口”>“绑定”)。在“服务器变量”对话框中,输入服务器变量的名称,并单击“确定”。
  2. 单击加号 (+) 按钮并从弹出菜单中选择服务器变量。
  3. 输入变量的名称,并单击“确定”。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 本地变量

本地变量是在 ColdFusion 页面中用 CFSET 标签或 CFPARAM 标签创建的。定义的本地变量即会出现在“绑定”面板中。

  1. 在“本地变量”对话框中,输入本地变量的名称,并单击“确定”。

定义 ASP 服务器变量

可以将以下 ASP 服务器变量定义为动态内容源:Request.Cookie、Request.QueryString、Request.Form、Request.ServerVariables 和 Request.ClientCertificates。

  1. 打开“绑定”面板(“窗口”>“绑定”)。
  2. 单击加号 (+) 按钮并从弹出菜单中选择“请求变量”。
  3. 在“请求变量”对话框中,从“类型”弹出菜单中选择以下请求集合之一:

    QueryString 集合

    检索附加到发送页面的 URL 中的信息(例如,当该页面包含使用 GET 方法的 HTML 表单时)。查询字符串由一个或多个名称/值对(例如 last=Smith、first=Winston)组成,这些名称/值对使用一个问号 (?). 如果查询字符串包含多个名称/值对,则使用 (&) 符号将它们合并在一起。

    Form 集合

    检索表单信息,这些信息包含在使用 POST 方法的 HTML 表单所发送的 HTTP 请求的正文中。

    ServerVariables 集合

    检索预定义环境变量的值。该集合含有一个很长的变量列表,包括 CONTENT_LENGTH(HTTP 请求中所提交内容的长度,可以用它查看表单是否为空)和 HTTP_USER_AGENT(提供有关用户浏览器的信息)。

    例如,Request.ServerVariables("HTTP_USER_AGENT") 包含有关提交信息的浏览器的信息,如 Mozilla/4.07 [en] (WinNT; I),表示浏览器为 Netscape Navigator 4.07 浏览器。

    有关 ASP 服务器环境变量的完整列表,请参阅与 Microsoft Personal Web Server (PWS) 或 Internet Information Server (IIS) 一起安装的在线文档。

    Cookies 集合

    检索在 HTTP 请求中发送的 Cookie 的值。例如,假设页面读取用户系统上的一个名为“readMe”的 Cookie。在服务器上,该 Cookie 的值保存在变量 Request.Cookies("readMe") 中。

    ClientCertificate 集合

    从浏览器发送的 HTTP 请求中检索认证域。X.509 标准中指定了认证域。

  4. 指定集合中您要访问的变量,并单击“确定”。

    例如,如果要访问 Request.ServerVariables("HTTP_USER_AGENT") 变量中的信息,请输入 HTTP_USER_AGENT。如果要访问 Request.Form("lastname") 变量中的信息,请输入参数 lastname。

    请求变量即会出现在“绑定”面板中。

定义 PHP 服务器变量

将服务器变量定义为 PHP 页的动态内容源。PHP 服务器变量即会出现在“绑定”面板中。

  1. 打开“绑定”面板(“窗口”>“绑定”)。
  2. 单击加号 (+) 按钮并从弹出菜单中选择该变量。
  3. 在“请求变量”对话框中,输入变量的名称(例如 REQUEST_METHOD),并单击“确定”。

    有关详细信息,请在 PHP 文档中搜索关键字 $_SERVER。

定义 ColdFusion 客户端变量

将 ColdFusion 客户端变量定义为页面的动态内容源。新定义的 ColdFusion 客户端变量即会出现在“绑定”面板中。

  1. 在“客户端变量”对话框中,输入变量的名称,并单击“确定”。

    例如,要访问 Client.LastVisit ColdFusion 变量中的信息,请输入 LastVisit。

    客户端变量是在代码中创建的、用于将数据和特定客户端关联的变量。当用户在应用程序中从一个页面移动到另一个页面或从一个会话移动到另一个会话时,客户端变量将会保持应用程序的状态。

    客户端变量可以是用户定义的也可以是内置的。下表列出了内置的 ColdFusion 客户端变量:

    变量

    说明

    Client.CFID

    每个连接到服务器的客户端的递增 ID。

    Client.CFTOKEN

    随机生成的用于唯一标识特定客户端的编号。

    Client.URLToken

    不使用 Cookie 时,在模板之间传递的 CFID 和 CFTOKEN 的组合。

    Client.LastVisit

    记录客户端所进行的最后一次访问的时间戳。

    Client.HitCount

    单个客户端的页面请求数(使用 CFID 和 CFTOKEN 跟踪)。

    Client.TimeCreated

    记录第一次为特定客户端创建 CFID 和 CFTOKEN 时的时间戳。

定义 ColdFusion Cookie 变量

Cookie 变量即会在代码中创建,并访问由浏览器传递给服务器的 Cookie 中包含的信息。定义的 Cookie 变量即会出现在“绑定”面板中。

  1. 在“Cookie 变量”对话框中,输入 Cookie 变量的名称,并单击“确定”。

定义 ColdFusion CGI 变量

定义的 CGI 变量即会出现在“绑定”面板中。

  1. 在“CGI 变量”对话框中,输入变量的名称,并单击“确定”。

    例如,如果要访问 CGI.HTTP_REFERER 变量中的信息,请输入 HTTP_REFERER。

    下表列出了在服务器中创建的最常见的 ColdFusion CGI 变量:

    变量

    说明

    SERVER_SOFTWARE

    回复请求(以及运行网关)的信息服务器软件的名称和版本。格式: name/version.

    SERVER_NAME

    服务器的主机名、DNS 别名或出现在自引用的 URL 中的 IP 地址。

    GATEWAY_INTERFACE

    该服务器遵守的 CGI 规范的修订版。格式: CGI/修订版。

    SERVER_PROTOCOL

    此请求附带的信息协议的名称和修订版。格式: 协议/修订版。

    SERVER_PORT

    该请求发送到的端口号。

    REQUEST_METHOD

    发送该请求时使用的方法。对于 HTTP,即为 Get、Head、Post 等。

    PATH_INFO

    客户端提供的额外路径信息。可以通过后跟额外信息的虚拟路径名访问脚本。额外信息作为 PATH_INFO 发送。

    PATH_TRANSLATED

    服务器提供 PATH_INFO 的转换版本,它采用该路径并对其执行任何虚拟-物理映射。

    SCRIPT_NAME

    所执行脚本的虚拟路径;用于自引用的 URL。

    QUERY_STRING

    引用此脚本的 URL 中问号 (?) 后面的 查询信息。

    REMOTE_HOST

    发送请求的主机名。如果服务器没有该项信息,它将设置 REMOTE_ADDR,但不设置 REMOTE_HOST。

    REMOTE_ADDR

    发送请求的远程主机的 IP 地址。

    AUTH_TYPE

    如果服务器支持用户身份验证,并且脚本是受保护的,则此变量是用于验证用户的、协议特定的身份验证方法。

    REMOTE_USER AUTH_USER

    如果服务器支持用户身份验证,并且脚本是受保护的,则此变量为已验证有效的用户名。(也可用作 AUTH_USER。)

    REMOTE_IDENT

    如果 HTTP 服务器支持 RFC 931 标识,此变量将设置为从服务器检索到的远程用户名。此变量仅用于日志记录。

    CONTENT_TYPE

    对于含有附加信息的查询(如 HTTP POST 和 PUT),此变量为数据的内容类型。

    CONTENT_LENGTH

    客户端提供的内容的长度。

    下表列出了由浏览器创建并传递给服务器的最常见的 CGI 变量:

    变量

    说明

    HTTP_REFERER

    引用文档。它指的是链接到或提交表单数据的文档。

    HTTP_USER_AGENT

    客户端当前用于发送请求的浏览器。格式: 软件/版本 库/版本。

    HTTP_IF_MODIFIED_SINCE

    最后一次修改页面的时间。浏览器负责发送此变量,通常是响应已发送 LAST_MODIFIED HTTP 标题的服务器。此变量可用于利用浏览器端的缓存。

缓存内容源

可以在“设计备注”中缓存或存储动态内容源。这样,即使您无法访问存储动态内容源的数据库或应用程序服务器,也可以在站点中工作。通过消除对数据库和应用程序服务器的网络重复访问,缓存还可能会加快开发速度。

  1. 单击“绑定”面板右上角的箭头按钮,并在弹出菜单中切换“缓存”。

如果对其中一个内容源进行了更改,可以单击“绑定”面板右上角的“刷新”按钮(圆形箭头图标)刷新缓存。(如果看不到该按钮,请展开面板。)

更改或删除内容源

可以更改或删除任何现有的动态内容源,即“绑定”面板中列出的任何内容源。

在“绑定”面板中更改或删除内容源不会 更改或删除页面中该内容的任何实例。而只是将它作为可能的页面内容源进行更改或删除。

在绑定面板中更改内容源

  1. 在“绑定”面板(“窗口”>“绑定”)中,双击要编辑的内容源的名称。
  2. 在出现的对话框中进行更改。
  3. 如果对所做的工作感到满意,请单击“确定”。

从绑定面板中删除内容源

  1. 在“绑定”面板(“窗口”>“绑定”)中,从列表中选择内容源。
  2. 单击减号 (-) 按钮。

将记录集从一个页面复制到另一个页面

在定义的站点内,可以将记录集从一个页面复制到另一个页面。

  1. 在“绑定”面板或“服务器行为”面板中选择记录集。
  2. 右键单击该记录集并从弹出菜单中选择“复制”。
  3. 打开您想要向其复制记录集的页面。
  4. 右键单击“绑定”面板或“服务器行为”工具栏,并从弹出菜单中选择“粘贴”。

更多此类内容

  • 适用于 ASP 开发人员的数据库连接
  • 适用于 PHP 开发人员的数据库连接
  • 添加预存过程 (ColdFusion)
  • SQL 入门
  • 关于 URL 参数和表单参数
  • 向页面添加动态内容
  • URL 参数
  • ColdFusion 服务器变量
  • 关于动态内容源
  • 使用表单从用户处收集信息
  • 会话变量的工作方式
  • 在会话变量中收集、存储和检索信息
  • 关于添加动态内容
  • HTML 表单参数
  • ColdFusion 服务器变量