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

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/UpdateListItemsWithKnowledge", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function UpdateListItemsWithKnowledge ( _
    listName As String, _
    updates As XmlNode, _
    syncScope As String, _
    knowledge As XmlNode _
) As XmlNode
'Usage
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("https://schemas.microsoft.com/sharepoint/soap/UpdateListItemsWithKnowledge", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode UpdateListItemsWithKnowledge(
    string listName,
    XmlNode updates,
    string syncScope,
    XmlNode knowledge
)

Parameters

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

• updates
  Type: System.Xml.XmlNode

  Specifies the operations to perform on a list item.

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

Remarks

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

Reference

Lists Class

Lists Members

Lists Web Service