Enabled Property (ReportCache)

Specifies whether the control should store rendered reports in the cache.

Syntax

Visual Basic
C#

'Declaration
 
<C1DescriptionAttribute(Key="C1ReportViewer.Cache.Enabled", Description="Specifies whether the control should store rendered reports in the cache.")>
<System.ComponentModel.NotifyParentPropertyAttribute(True)>
<System.ComponentModel.RefreshPropertiesAttribute(RefreshProperties.All)>
<C1CategoryAttribute("Behavior")>
<System.ComponentModel.DefaultValueAttribute()>
Public Property Enabled As System.Boolean

[C1Description(Key="C1ReportViewer.Cache.Enabled", Description="Specifies whether the control should store rendered reports in the cache.")]
[System.ComponentModel.NotifyParentProperty(true)]
[System.ComponentModel.RefreshProperties(RefreshProperties.All)]
[C1Category("Behavior")]
[System.ComponentModel.DefaultValue()]
public System.bool Enabled {get; set;}

Property Value

true if enabled; otherwise, false.

Remarks

This property is set to true by default, allowing the C1.Web.Wijmo.Controls.C1ReportViewer.C1ReportViewer to use the System.Web.UI.Page.Cache object to store frequently used reports. This enhances performance significantly, but it does use some server resources.

If you want to reduce the memory requirements on the server, setting the Enabled property to false will cause the C1.Web.Wijmo.Controls.C1ReportViewer.C1ReportViewer control not to use the cache. Reports will be rendered every time they are requested, and memory usage will be reduced at the expense of more data access and processing time needed to create the reports multiple times.

In general, you should only turn the cache off if you are rendering a custom report that probably won't be requested again in the next few hours.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ReportCache Class
ReportCache Members