SPSite.GetChanges method

Returns the default number of changes listed in the current change log for the site collection.

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


Public Function GetChanges As SPChangeCollection
Dim instance As SPSite
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.


The total number of changes returned by a query against the change log could 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.

See also


SPSite class

SPSite members

GetChanges overload

Microsoft.SharePoint namespace

Other resources

Using the Change Log