ASPxVerticalGrid.EnableRecordsCache Property

Gets or sets whether data caching is enabled.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(true)]
public bool EnableRecordsCache { get; set; }

VB.NET

<DefaultValue(True)>
Public Property EnableRecordsCache As Boolean

Property Value

Type	Default	Description
Boolean	true	true, to enable data caching; otherwise, false.

Remarks

By default, the ASPxVerticalGrid stores data in memory for quick access. This avoids repeated database calls when performing various operations that don’t require reloading data (e.g., rearranging or hiding rows). As a result, this increases the Web application scalability.

To disable data caching, set the EnableRecordsCache option to false. This can be useful, for instance, when the ASPxVerticalGrid displays real-time data. It’s also recommended that you disable this option when binding to data created at runtime, because calling the DataBind() method always reloads data from the server.

Note

The EnableRecordsCache option must be disabled when using custom grouping intervals defined via the GridViewDataColumnSettings.GroupInterval property.

Note

If you use custom objects that utilize a referenced association, the ASPxVerticalGrid tries to cache references too. The serialization of a custom object is performed by the ToString method and is performed smoothly. But the object deserialization (restoration from String to object) could be raised with an exception:

TypeConverter cannot convert from System.String.

One solution is to turn off the ASPxVerticalGrid.EnableRecordsCache property. This solution is acceptable when the page doesn’t have several grids, and in most cases, doesn’t affect page performance significantly.

However, you can implement a custom TypeConverter derived class that can convert from the String type correctly. To learn more, see the Code Central example: How to implement a custom TypeConverter class for an XPO object