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)

public SPChangeCollection GetChanges()

Return value

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

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.


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