element <changeQuery> (local)
Namespace:
http://schemas.microsoft.com/hs/2001/10/core
Type:
changeQueryType
Content:
complex, 2 attributes, 1 element
Defined:
locally within queryRequestType complexType in hsdl.xsd; see XML source
XML Representation Summary
<changeQuery
   
 = 
xsd:nonNegativeInteger
 = 
xsd:string
   
>
   
Content: 
</changeQuery>
Content model elements (1):
options (type queryOptionsType)
Included in content model of elements (1):
queryRequest
Annotation
This element is used to request a list of updates relative to a single selected node and a <b>changeNumber</b> value on that node. It is designed specifically to support client-side caching of .NET My Services content. Any <b>xdb:blue</b> node can be selected with the <b>select</b> attribute. It is an error condition to select more than a single node. While this element does not support <b>minOccurs/maxOccurs</b> attributes, it is as if <b>minOccurs</b>=0 and <b>maxOccurs</b>=1. The response to this message is an <b>updateRequest</b> message that contains the insert, replace, and delete operations that should be processed by the client software to bring its cache up to date with respect to the change number specified in this element. <p/> There will be times when the .NET My Services system will be unable to return a <b>changeQueryResponse</b> that is complete enough bring a client cache in sync. This can occur when the client is way out of date and numerous delete operations have occurred. In these situations, a <b>changeQuery</b> will simply fail with a fault condition and, in response to this message, the client should discard and rebuild its cache.
XML Source (see within schema source)
<xsd:element maxOccurs="unbounded" minOccurs="0" name="changeQuery" type="changeQueryType">
<xsd:annotation>
<xsd:documentation>
This element is used to request a list of updates relative to a single
selected node and a
<b>changeNumber</b>
value on that node. It is designed specifically
to support client-side caching of .NET My Services content. Any
<b>xdb:blue</b>
node
can be selected
with the
<b>select</b>
attribute. It is an error condition to select more than a single node. While
this element does not support
<b>minOccurs/maxOccurs</b>
attributes, it is as if
<b>minOccurs</b>
=0 and
<b>maxOccurs</b>
=1.
The response to this message is an
<b>updateRequest</b>
message that contains the insert, replace,
and delete operations that should be processed by the client software to bring its
cache up to date with respect to the change number specified in this element.
<p/>
There will be times when the .NET My Services system will be unable to return a
<b>changeQueryResponse</b>
that is complete enough bring a client cache in sync. This
can occur when the client is way out of date and numerous delete operations have occurred. In these
situations, a
<b>changeQuery</b>
will simply fail with a fault condition
and, in response to this
message, the client should discard and rebuild its cache.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
Attribute Detail (all declarations; 2/2)
baseChangeNumber
Type:
changeNumberType
Use:
required
Defined:
locally within changeQueryType complexType
This attribute specifies the <b>changeNumber</b> value that the client has in its cache for the node specified by the <b>select</b> attribute. As explained above, this value establishes the synchronization base used to compute the changes underneath this node.
XML Source (see within schema source)
<xsd:attribute name="baseChangeNumber" type="changeNumberType" use="required">
<xsd:annotation>
<xsd:documentation>
This attribute specifies the
<b>changeNumber</b>
value that the client has in its cache for
the node specified by the
<b>select</b>
attribute. As explained above, this value establishes
the synchronization base used to compute the changes underneath this node.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
select
Type:
string
Use:
required
Defined:
locally within changeQueryType complexType
This attribute specifies an XPath expression that specifies the single node that the change query is relative to. This node, in conjunction with the specified <b>changeNumber</b> attribute, controls the change computation. The selected node is located, and all nodes containing <b>id</b> attributes (of type <b>idType</b>) are examined. Any nodes that have changed relative to the specified <b>changeNumber</b> are returned in the <b>updateRequest</b>.
XML Source (see within schema source)
<xsd:attribute name="select" type="string" use="required">
<xsd:annotation>
<xsd:documentation>
This attribute specifies an XPath expression that specifies the single node that the change
query is relative to. This node, in conjunction with the specified
<b>changeNumber</b>
attribute,
controls the change computation. The selected node is located, and all nodes containing
<b>id</b>
attributes (of type
<b>idType</b>
) are examined. Any nodes that have changed
relative to the specified
<b>changeNumber</b>
are returned in the
<b>updateRequest</b>
.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
Content Element Detail (all declarations; 1/1)
options
Type:
queryOptionsType, complex content
Defined:
locally within changeQueryType complexType
TBD
XML Source (see within schema source)
<xsd:element maxOccurs="1" minOccurs="0" name="options" type="queryOptionsType">
<xsd:annotation>
<xsd:documentation>
TBD
</xsd:documentation>
</xsd:annotation>
</xsd:element>