Class CacheDataRecord
This record is stored on a separate stream that maintains information about each PivotTable cache. The record is followed by a single CacheDataExRecord and several FDB records, one for each field in the PivotTable. SXDBEX in Excel specification.
Inheritance
Inherited Members
Namespace: Syncfusion.XlsIO.Parser.Biff_Records.PivotTable
Assembly: Syncfusion.XlsIO.Base.dll
Syntax
[CLSCompliant(false)]
[Biff(TBIFFRecord.CacheData)]
public class CacheDataRecord : BiffRecordRaw, ICloneable, IBiffStorage
Constructors
CacheDataRecord()
Default constructor.
Declaration
public CacheDataRecord()
CacheDataRecord(Int32)
Reserved for record's internal data array.
Declaration
public CacheDataRecord(int iReserve)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | iReserve | Amount of bytes for the data array. |
Exceptions
| Type | Condition |
|---|---|
| System.ArgumentOutOfRangeException | If amount of bytes requested is less than zero. |
CacheDataRecord(Stream, out Int32)
Read / initialize constructor.
Declaration
public CacheDataRecord(Stream stream, out int itemSize)
Parameters
| Type | Name | Description |
|---|---|---|
| System.IO.Stream | stream | Stream from which record data should be read. |
| System.Int32 | itemSize | Size of read item. |
Exceptions
| Type | Condition |
|---|---|
| System.ArgumentNullException | When stream is not specified. |
| System.ApplicationException | When stream does not support read or seek operations. |
Properties
BaseFieldsCount
Number of base fields in databases.
Declaration
public ushort BaseFieldsCount { get; set; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
FieldsNumber
Number of base fields, grouped fields, and calculated fields.
Declaration
public ushort FieldsNumber { get; set; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
IsBackgroundQuery
Indicates whether results of the query are obtained in the background.
Declaration
public bool IsBackgroundQuery { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsEnableRefresh
Indicates whether refresh is enabled.
Declaration
public bool IsEnableRefresh { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsInvalid
Indicates whether the PivotTable must be refreshed before next update.
Declaration
public bool IsInvalid { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsOptimizeCache
Indicates whether the cache is optimized to use the least amount of memory.
Declaration
public bool IsOptimizeCache { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsRefreshOnLoad
Indicates whether the PivotTable will be refreshed on load.
Declaration
public bool IsRefreshOnLoad { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsSaveData
Indicates whether data is being saved with table layout.
Declaration
public bool IsSaveData { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
Options
Option flags.
Declaration
public ushort Options { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
RecordsInBlock
Number of records for each database block.
Declaration
public ushort RecordsInBlock { get; set; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
RecordsNumber
Number of records in database.
Declaration
public int RecordsNumber { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
Reserved
This value is not used and can be set to zero. Read-only.
Declaration
public ushort Reserved { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
SourceType
Data source is one of: 1 - Excel worksheet, 2 - external data, 4 - consolidation, 8 - scenario PivotTable.
Declaration
public ExcelDataSourceType SourceType { get; set; }
Property Value
| Type | Description |
|---|---|
| ExcelDataSourceType |
StreamId
Identifies the stream.
Declaration
public ushort StreamId { get; set; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
UserName
The user who last refreshed the PivotTable.
Declaration
public string UserName { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String |
UserNameSize
Number of characters in the string containing the name of the user who last refreshed the PivotTable. Read-only.
Declaration
public ushort UserNameSize { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
Methods
FillCache(IRange)
Fills cache with data from the range.
Declaration
public void FillCache(IRange dataRange)
Parameters
| Type | Name | Description |
|---|---|---|
| IRange | dataRange | Data range to fill. |
GetStoreSize(ExcelVersion)
Evaluates size of the required storage space.
Declaration
public override int GetStoreSize(ExcelVersion version)
Parameters
| Type | Name | Description |
|---|---|---|
| ExcelVersion | version |
Returns
| Type | Description |
|---|---|
| System.Int32 | Size of the required storage space. |
Overrides
ParseStructure(DataProvider, Int32, Int32, ExcelVersion)
Parse structure of record. Converts data buffer to special values according to record specification.
Declaration
public override void ParseStructure(DataProvider provider, int iOffset, int iLength, ExcelVersion version)
Parameters
| Type | Name | Description |
|---|---|---|
| DataProvider | provider | Object that provides access to the data. |
| System.Int32 | iOffset | Offset to the record's data. |
| System.Int32 | iLength | Length of the record's data. |
| ExcelVersion | version | Excel version used for infill. |