PageControl 数据对象

PageControl 使您的应用程序可以检索搜索结果的其他页面。

PageControl 数据对象的结构由以下内容组成:
size
指示页面的大小。
cookie
包含从 PageResponseControl 返回的 cookie,以使服务器能够获取下一个要搜索的页面。对于首次调用页面调度搜索,此属性不会设置为任何值。
注: 如果为 SearchControl 指定了 countLimit 属性,那么无法使用 PageControl。它们是互斥的。

XML 模式定义

以下是 PageControl 数据对象的 XML 模式定义:
<xsd:complexType name="PageControl">
	<xsd:complexContent>
		<xsd:extension base="Control">
			<xsd:attribute name="size" type="xsd:int"/>
			<xsd:attribute name="cookie" type="xsd:hexBinary"/>
		</xsd:extension>
	</xsd:complexContent>
	</xsd:complexType>

样本数据对象

以下是在第一个页面的 search API 中使用的样本 PageControl 数据对象。此数据对象中没有 cookie 属性。其指示仅返回 10 个结果,即使搜索结果大于 10 个。
<controls xsi:type="PageControl" size="10"/>
以下是在后续页面的 search API 中使用的样本 PageControl 数据对象。设置了从 PageResponseControl 返回的 cookie 属性。
<wim:controls xsi:type="wim:PageControl" 
     cookie="57494D53656172636843616368654E616D6574696D653A31313239353538343136383636"
     size="10"/>
以下是 search API 中使用的一个样本 PageControl 数据对象,用以指示停止搜索。要停止对搜索结果进行页面调度,请在设置了 cookie 的情况下将页面大小设置为 0。
<wim:controls xsi:type="wim:PageControl" 
   cookie="57494D53656172636843616368654E616D6574696D653A31313239353538343136383636" 
   size="0"/>


使用条款 | 反馈