ReportingService2006.GetCacheOptions Method

Returns the cache configuration for a report and the settings that describe when the cached copy of the report expires.

Namespace:  ReportService2006
Assembly:  ReportService2006 (in ReportService2006.dll)

Syntax

'Declaration
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/GetCacheOptions", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function GetCacheOptions ( _
    Report As String, _
    <OutAttribute> ByRef Item As ExpirationDefinition _
) As Boolean
'Usage
Dim instance As ReportingService2006
Dim Report As String
Dim Item As ExpirationDefinition
Dim returnValue As Boolean

returnValue = instance.GetCacheOptions(Report, _
    Item)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/GetCacheOptions", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public bool GetCacheOptions(
    string Report,
    out ExpirationDefinition Item
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/GetCacheOptions", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
bool GetCacheOptions(
    String^ Report, 
    [OutAttribute] ExpirationDefinition^% Item
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/GetCacheOptions", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member GetCacheOptions : 
        Report:string * 
        Item:ExpirationDefinition byref -> bool 
public function GetCacheOptions(
    Report : String, 
    Item : ExpirationDefinition
) : boolean

Parameters

  • Report
    Type: System.String
    The fully qualified URL of the report including the file name and .rdl file name extension.

Return Value

Type: System.Boolean
true if a copy of an executed report is put in cache; otherwise, false.

Remarks

The table below shows header and permissions information on this operation.

SOAP Headers

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

ViewListItems()

Use the return value of this method to evaluate whether the report is set to be cached. If the value is false, the method returns a nulla null reference (Nothing in Visual Basic) (or Nothing in Visual Basic) for Item.

Use GetCacheOptions only if the execution option is configured to run on demand. For more information about the cache settings of a report, see Caching Reports (SSRS). For information about programmatically setting the caching options of a report, see SetCacheOptions method.