SPList.GetChanges method

Returns the default number of changes from the current change log for the list.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Function GetChanges As SPChangeCollection
'Usage
Dim instance As SPList
Dim returnValue As SPChangeCollection

returnValue = instance.GetChanges()
public SPChangeCollection GetChanges()

Return value

Type: Microsoft.SharePoint.SPChangeCollection
A collection of SPChange objects that represent the changes.

Remarks

The total number of changes returned by a query against the change log can be very large. For performance reasons, changes are returned in batches of limited size. This overload of the GetChanges method returns only the first batch of changes recorded in the log.

If you want all changes rather than only the first batch, your code should call the GetChanges method in a loop until it returns a collection with zero changes, signifying that it has reached the end of the log. You can use the ChangeToken from the last change of the first batch to get the second batch, and so on until you get an empty collection. For an example, see the GetChanges(SPChangeToken) method.

Note

By default, the change log retains data for 60 days. You can configure the retention period by setting the ChangeLogRetentionPeriod property.

See also

Reference

SPList class

SPList members

GetChanges overload

Microsoft.SharePoint namespace

Other resources

Using the Change Log