PageControl
permet à votre application d'extraire des pages supplémentaires des résultats de la recherche.
La structure d'un objet de données PageControl se compose des éléments suivants :
- size
- indique la taille de la page.
- cookie
- contient le cookie renvoyé par un objet de données PageResponseControl afin
de permettre au serveur de récupérer la page suivante de la recherche. Pour le
premier appel d'une recherche de nombre de page, cette propriété ne doit être
définie sur aucune valeur.
Remarque : Si
la propriété countLimit est indiquée pour SearchControl, vous ne pouvez
pas utiliser PageControl. Ils sont incompatibles.
Définition de schéma XML
Vous
trouverez ci-dessous la définition du schéma XML pour l'objet de données PageControl :
<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>
Objet de données exemple
Vous
trouverez ci-dessous un exemple d'objet de données PageControl utilisé dans
l'interface de programme d'application de recherche pour la première page. Aucune
propriété de cookie n'existe dans cet objet de données. Il indique qu'il faut
renvoyer 10 résultats uniquement, même si les résultats de la recherche
sont supérieurs.
<controls xsi:type="PageControl" size="10"/>
Voici un exemple d'objet de données PageControl utilisé dans l'interface de
programme d'application de recherche de la page suivante. La propriété de
cookie renvoyée d'un objet PageResponseControl est définie.
<wim:controls xsi:type="wim:PageControl"
cookie="57494D53656172636843616368654E616D6574696D653A31313239353538343136383636"
size="10"/>
Voici
un exemple d'objet de données PageControl utilisé dans l'interface de
programme d'application de recherche pour indiquer d'arrêter la recherche. Pour
arrêter les résultats de recherche du nombre de page, définissez le volume de
page sur 0 avec le cookie défini.
<wim:controls xsi:type="wim:PageControl"
cookie="57494D53656172636843616368654E616D6574696D653A31313239353538343136383636"
size="0"/>