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 Function UpdateListItemsWithKnowledge ( _
    listName As String, _
    updates As XmlNode, _
    syncScope As String, _
    knowledge As XmlNode _
) As XmlNode
Dim instance As Lists
Dim listName As String
Dim updates As XmlNode
Dim syncScope As String
Dim knowledge As XmlNode
Dim returnValue As XmlNode

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


  • listName
    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".

  • syncScope
    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.

  • knowledge
    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.

See Also


Lists Class

Lists Members

Lists Web Service