The session state management system can be configured by specifying one or more session state providers in the Telerik Reporting Configuration Section
of the application’s configuration file. For example, the following XML snippet configures the session state to
store the rendered pages and resources in the file system:
CopyXML
<Telerik.Reporting>
<SessionState provider="File" />
</Telerik.Reporting>
The "provider" attribute of the "SessionState" element specifies the name of the current session state provider used by the viewers. There
are several preconfigured providers that can be used by applications without any additional setup:
| Provider |
Description |
| Auto |
The actual provider is chosen automatically according to the characteristics of the stored resource and the permissions granted to
the application. This is the default setting if the "SessionState" element is omitted from the configuration section. |
| Memory |
All rendered pages and resources are stored in memory. Use this setting to improve the performance when rendering relatively small
reports in desktop applications. However this could also increase the memory footprint of the application significantly for large
reports. |
| File |
All rendered pages and resources are stored as temporary files in the file system. |
| IsolatedStorage |
All rendered pages and resources are stored as temporary files in the isolated storage. |
Except the preconfigured session state providers, additional providers can be registered under the "Providers" child element of the
"SessionState" element. For example, Telerik Reporting is distributed with a session state provider that utilizes the Open Access
ORM to store session state in a database. The following code snippet demonstrates how to configure this provider:
CopyXML
<Telerik.Reporting>
<SessionState provider="Database">
<Providers>
<Provider name="Database" type="Telerik.Reporting.DatabaseSession.DatabaseSessionProvider, Telerik.Reporting.DatabaseSession, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be">
<Parameters>
<Parameter name="BackendName" value="mssql" />
<Parameter name="ConnectionString" value="MyConnectionString" />
</Parameters>
</Provider>
</Providers>
</SessionState>
</Telerik.Reporting>
The individual providers are registered by adding one or more "Provider" elements. Here the "name" attribute specifies the friendly
name of the provider and the "type" attribute specifies the assembly-qualified type name of that provider.
If the provider requires additional parameters, these can be specified under the "Parameters" child element of the "Provider" element. The
individual parameters are specified by adding one or more "Parameter" elements. Here the "name" attribute specifies the name of the
parameter and the "value" attribute specifies the value of that parameter.
The following table lists all session state providers distributed with Telerik Reporting:
| Provider |
Description |
Type |
| Auto |
Chooses the storage automatically according to the characteristics of the stored resources and granted permissions to the application. |
Telerik.Reporting.Processing.Session.SmartSessionProvider, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
| Memory |
Stores all resources in memory. |
Telerik.Reporting.Processing.Session.MemorySessionProvider, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
| File |
Stores all resources as temporary files in the file system. |
Telerik.Reporting.Processing.Session.FileSessionProvider, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
| IsolatedStorage |
Stores all resources as temporary files in the isolated storage. |
Telerik.Reporting.Processing.Session.IsolatedStorageSessionProvider, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
| Database |
Stores all resources in database. Uses Open Access ORM to access the database. |
Telerik.Reporting.DatabaseSession.DatabaseSessionProvider, Telerik.Reporting.DatabaseSession, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
| ADO.NET |
Stores all resources in database. Uses ADO.NET provider to access the database. |
Telerik.Reporting.Processing.Session.AdoNetSessionProvider, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be |
See Also