Export (0) Print
Expand All

Lists.UpdateListItemsWithKnowledge method

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

Namespace:  WebSvcLists
Assembly:  STSSOAP (in STSSOAP.dll)

'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/UpdateListItemsWithKnowledge", RequestNamespace := "http://schemas.microsoft.com/sharepoint/soap/",  _
	ResponseNamespace := "http://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)

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.

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.

Community Additions

ADD
Show:
© 2014 Microsoft