cache Element Overview

The Cache element specifies the configuration settings for the cache management system which is utilized by the viewers to store and cache rendered pages and resources.

Attributes and Elements

<cache> element

Attributes	provider – required string attribute. Specifies the name of the current active cache provider used by the viewers. There are several preconfigured providers, although additional ones can be registered in this part of the configuration section. The following cache providers are available by default: Auto - the actual provider is chosen automatically according to the characteristics of the stored resource and the permissions granted to the application; Memory – specifies that the rendered pages and resources are stored in memory; File – specifies that the rendered pages and resources are stored as temporary files in the file system; IsolatedStorage – specifies that the rendered pages and resources are stored as temporary files in the isolated storage.
Child elements	providers – specifies a collection of cache providers to register for use in the application. Only one Provider child element can be used inside the Cache parent element.
Parent element	Telerik.Reporting – specifies the root element of the Telerik Reporting configuration settings. Only one Cache child element can be used inside the Telerik.Reporting root element.

<providers> element

The Providers element specifies a collection of cache providers to register for use in the application.

Attributes	No attributes are defined for this element.
Child elements	provider – specifies a cache provider to register for use in the application. Multiple Provider child elements can be used inside a single Providers parent element.
Parent element	cache – specifies the configuration settings for the cache used by the viewers. Only one Provider child element can be used inside the Cache parent element.

<provider> element

The Provider element specifies a cache provider to register for use in the application.

Attributes	name – required string attribute. Specifies a unique name to identify the cache provider in the configuration section. The active cache provider specified by the provider attribute of the Cache element should match one of the names specified by this attribute.
Child elements	parameters – specifies a collection of parameters for the current cache provider. Only one parameters child element can be used in the provider parent element.
Parent element	providers – specifies a collection of cache providers to register for use in the application. Multiple provider child elements can be used inside a single providers parent element.

Example

XML-based configuration file:

<configuration>
    …
    <Telerik.Reporting>
        <cache provider="File">
            <providers>
                <provider name="File">
                    <parameters>
                        <parameter name="BasePath" value="C:\MyDataCache" />
                    </parameters>
                </provider>
            </providers>
        </cache>
    </Telerik.Reporting>
    …
</configuration>

JSON-based configuration file:

"telerikReporting": {
    "cache": {
        "provider": "File",
        "providers": [
            {
                "name": "File",
                "parameters": [
                    {
                        "name": "BasePath",
                        "value": "c:\\MyDataCache"
                    }
                ]
            }
        ]
    }
}