Telerik Reporting

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