Lists.UpdateListItemsWithKnowledge Method

Makes inserts, updates, and deletions to specified list items and provides the server with current knowledge metadata.

Namespace:  [Lists Web service]
Web service reference: http://Site/_vti_bin/Lists.asmx

[SoapDocumentMethodAttribute("", RequestNamespace = "", 
	ResponseNamespace = "", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode UpdateListItemsWithKnowledge(
	string listName,
	XmlNode updates,
	string syncScope,
	XmlNode knowledge


Type: System.String

The GUID or the list title of the list from which to retrieve list items. If the specified list is the user information list, the string is set to "UserInfo" or "User Information list".

Type: System.Xml.XmlNode

Specifies the operations to perform on a list item.

Type: System.String

Specifies the scope of the synchronization. If a null reference (Nothing in Visual Basic), the default sync scope is used with an empty identifier.

Type: System.Xml.XmlNode

Specifies the Microsoft Sync Framework knowledge data structure in XML format. If not provided by the client, all items in the list are returned, subject to the default row limit of the view or the overriding rowLimit parameter. If specified, the response will include changes made to list items after the knowledge was retrieved, subject to the row limit restrictions.

Return Value

Type: System.Xml.XmlNode
Returns a XmlNode object representing updates to list items as well as to item knowledge.

Conflicts are detected on server side using the ows_hiddenversion field on the list item. If the value of the field does not match value in the item in the database, then a conflicting update is detected and an error is returned to the client. Conflicting items are also reported back in the response message. Clients must then get a new version of the list item, resolve the conflict, update the value of the ows_hiddenversion field and then try to update item again.