ReportingService2010.SetItemHistoryLimit Method (String, Boolean, Int32)
Specifies the number of snapshots of an item that the report server retains. This method applies to the Report item type.
Assembly: ReportService2010 (in ReportService2010.dll)
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemHistoryLimit", RequestNamespace := "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace := "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> <SoapHeaderAttribute("TrustedUserHeaderValue")> <SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> Public Sub SetItemHistoryLimit ( ItemPath As String, UseSystem As Boolean, HistoryLimit As Integer )
Parameters
- ItemPath
-
Type:
System.String
The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.
- UseSystem
-
Type:
System.Boolean
A Boolean expression that, when set to true, sets the item history limit to the current system item history limit. A value of false indicates that the item history limit corresponds to the value supplied in the HistoryLimit parameter.
- HistoryLimit
-
Type:
System.Int32
The number of item history snapshots to store for the item. Values can range from -1 to 2,147,483,647. If the value is set to –1, all item snapshots are saved.
The table below shows header and permissions information on this operation.
SOAP Header Usage | (Out) ServerInfoHeaderValue |
Native Mode Required Permissions | |
SharePoint Mode Required Permissions |
This method only supports the Report item type. Specifying the URL of any item other than a report causes the method to throw an exception with the exception string "Wrong Item Type".
If the UseSystem parameter is set to true, the report server ignores the HistoryLimit parameter.
![]() |
---|
If the value of HistoryLimit is changed, item history snapshots may be deleted. |