第四十一章 构建数据库应用程序 - 带有<CSP: Search>标签的CSP搜索页面
search标记创建一个通用搜索页面，可以将其与绑定表单一起使用以执行查找操作。
应用程序用户可以从包含绑定表单的页面访问CSP Search页面，并使用它在数据库中查找匹配一组标准的对象。
然后，用户可以选择其中一个对象并编辑它。
Search标记生成一个显示搜索页面的客户端JavaScript函数。搜索页面由%CSP.PageLookup在类中显示。
Search标记包括使能够控制搜索页面操作的属性。这些措施包括：
csp:search Tag Attributes
| Attribute | Description |
|---|---|
CAPTION |
可选的。标准搜索页面中显示的标题字符串。 |
CLASSNAME |
必需的。要对其执行搜索的类的名称。 |
FEATURES |
可选的。当使用弹出搜索窗口时，字符串包含传递给JavaScript window.open方法的Feature参数。这使您可以更好地控制弹出窗口的显示方式。 |
MAXROWS |
可选。指定要在搜索结果表中显示的最大行数。默认值为100。 |
NAME |
必需的。调用搜索页面的生成的客户端JavaScript函数的名称。 |
OBJID |
调用搜索页面时显示的对象的对象ID值。这用于在用户取消搜索时重新显示旧页面。 |
ONSELECT |
可选。在弹出搜索页面中，当用户选择特定搜索结果时要调用的JavaScript函数的名称。使用所选对象的对象ID值调用此函数。 |
OPTIONS |
可选。搜索页面选项的逗号分隔列表。这些选项包括创建弹出搜索窗口的“popup”和显示搜索谓词下拉列表的“predicate”。 |
ORDER |
可选。作为搜索结果排序依据的字段名称。 |
SELECT |
可选。要在搜索结果表中显示的以逗号分隔的字段列表。如果未指定，则将WHERE列表用作选择列表。 |
STARTVALUES |
可选。调用搜索页的表单中控件名称的逗号分隔列表，其内容用作搜索页中的种子值。列表中名称的顺序与搜索页面中的条件字段(由WHERE属性指定)相对应。 |
TARGET |
可选。在非弹出搜索页面中，指定搜索结果窗口中的链接指向的页面的名称。这是用户做出选择时显示的页面。默认值是调用搜索的页面。 |
WHERE |
必需的。用作搜索页面标准的以逗号分隔的字段列表。除非指定了SELECT属性，否则这些字段也会显示在搜索结果表中。 |
例如，以下代码定义了一个名为MySearch的JavaScript函数；该函数将显示一个弹出搜索窗口，用于搜索Sample.Person在按名称对象：
<csp:search NAME="MySearch" WHERE="Name" CLASSNAME="Sample.Person"
OPTIONS="popup" STARTVALUES="Name" ONSELECT="MySearchSelect">
此搜索页面的ONSELECT回调函数如下所示。
<script language="JavaScript">
function MySearchSelect(id)
{
#server(..MyFormLoad(id))#;
return true;
}
</script>
该函数使用CSP #server()#指令调用服务器端方法MyFormLoad。MyFormLoad方法是使用cspind将HTML表单MyForm绑定到对象后自动生成的。此方法使用对象ID为id的对象的属性值填充表单的内容。
有关其他示例，请参阅CSP示例页Form.csp在新选项卡中打开并在新选项卡中打开popform.csp.