Class WorksheetBaseImpl
Base class for all worksheet objects (objects that have own tab in the workbook) like worksheets and charts.
Inherited Members
Namespace: Syncfusion.XlsIO.Implementation
Assembly: Syncfusion.XlsIO.Base.dll
Syntax
public abstract class WorksheetBaseImpl : CommonObject, IDisposable, INamedObject, IParseable, ITabSheet, IParentApplication, ICloneParent
Constructors
WorksheetBaseImpl(IApplication, Object)
Initializes new instance and sets its application and parent properties.
Declaration
public WorksheetBaseImpl(IApplication application, object parent)
Parameters
Type | Name | Description |
---|---|---|
IApplication | application | Application object for the new instance. |
System.Object | parent | Parent object for the new instance. |
WorksheetBaseImpl(IApplication, Object, BiffReader, ExcelParseOptions, Boolean, Dictionary<Int32, Int32>, IDecryptor)
Initializes new instance and sets its application and parent properties.
Declaration
public WorksheetBaseImpl(IApplication application, object parent, BiffReader reader, ExcelParseOptions options, bool bSkipParsing, Dictionary<int, int> hashNewXFormatIndexes, IDecryptor decryptor)
Parameters
Type | Name | Description |
---|---|---|
IApplication | application | Application object for the new instance. |
System.Object | parent | Parent object for the new instance. |
BiffReader | reader | BiffReader to extract data from. |
ExcelParseOptions | options | Parse options. |
System.Boolean | bSkipParsing | Indicates whether to skip parsing. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | hashNewXFormatIndexes | Dictionary with new extended format indexes for ignore styles mode. |
IDecryptor | decryptor | Object used to decrypt encrypted records. |
Fields
DEF_DEFAULT_TAB_COLOR
Default tab color.
Declaration
public const ExcelKnownColors DEF_DEFAULT_TAB_COLOR
Field Value
Type |
---|
ExcelKnownColors |
DEF_MAX_COLUMN_ONE_INDEX
Maximum one-based index of the column.
Declaration
public const int DEF_MAX_COLUMN_ONE_INDEX = 256
Field Value
Type |
---|
System.Int32 |
DEF_MAX_PASSWORDLEN
Maximum length of the password.
Declaration
public const int DEF_MAX_PASSWORDLEN = 255
Field Value
Type |
---|
System.Int32 |
DEF_MAX_ROW_ONE_INDEX
Maximum one-based index of the row.
Declaration
public const int DEF_MAX_ROW_ONE_INDEX = 65536
Field Value
Type |
---|
System.Int32 |
DEF_MIN_COLUMN_INDEX
Min column index.
Declaration
public const int DEF_MIN_COLUMN_INDEX = 2147483647
Field Value
Type |
---|
System.Int32 |
DEF_MIN_ROW_INDEX
Min row index.
Declaration
public const int DEF_MIN_ROW_INDEX = -1
Field Value
Type |
---|
System.Int32 |
KeepRecord
Indicates whether to keep record inside of internal storage.
Declaration
protected bool KeepRecord
Field Value
Type |
---|
System.Boolean |
m_arrRecords
List in which all records which belong to worksheet are stored.
Declaration
protected List<BiffRecordRaw> m_arrRecords
Field Value
Type |
---|
System.Collections.Generic.List<Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw> |
m_book
Parent workbook.
Declaration
protected WorkbookImpl m_book
Field Value
Type |
---|
WorkbookImpl |
m_dataHolder
Data holder for 2007 Excel.
Declaration
protected WorksheetDataHolder m_dataHolder
Field Value
Type |
---|
WorksheetDataHolder |
m_errorIndicators
Collection of worksheet's error indicators.
Declaration
protected ErrorIndicatorsCollection m_errorIndicators
Field Value
Type |
---|
ErrorIndicatorsCollection |
m_iFirstColumn
One field from Worksheet dimension records.
Declaration
protected int m_iFirstColumn
Field Value
Type |
---|
System.Int32 |
m_iFirstRow
One field from Worksheet dimension records.
Declaration
protected int m_iFirstRow
Field Value
Type |
---|
System.Int32 |
m_iLastColumn
One field from Worksheet dimension records.
Declaration
protected int m_iLastColumn
Field Value
Type |
---|
System.Int32 |
m_iLastRow
One field from Worksheet dimension records
Declaration
protected int m_iLastRow
Field Value
Type |
---|
System.Int32 |
m_iMsoStartIndex
Starting index for Mso record.
Declaration
protected int m_iMsoStartIndex
Field Value
Type |
---|
System.Int32 |
m_isCustomHeight
Custom height
Declaration
protected bool m_isCustomHeight
Field Value
Type |
---|
System.Boolean |
m_parseOptions
Parse options.
Declaration
protected ExcelParseOptions m_parseOptions
Field Value
Type |
---|
ExcelParseOptions |
m_rangeProtectionRecord
Represents Range Protection Record
Declaration
protected RangeProtectionRecord m_rangeProtectionRecord
Field Value
Type |
---|
RangeProtectionRecord |
m_strCodeName
Code name.
Declaration
protected string m_strCodeName
Field Value
Type |
---|
System.String |
Properties
AlgorithmName
Alogrithm name to protect/unprotect worksheet.
Declaration
public string AlgorithmName { get; set; }
Property Value
Type |
---|
System.String |
Charts
Gets charts collection in the worksheet. Read-only.
Declaration
public IChartShapes Charts { get; }
Property Value
Type |
---|
IChartShapes |
CheckBoxes
Gets inner checkboxes collection in the sheet. Read-only.
Declaration
public ICheckBoxes CheckBoxes { get; }
Property Value
Type |
---|
ICheckBoxes |
CodeName
Name used by macros to access workbook items. Read-only.
Declaration
public string CodeName { get; }
Property Value
Type |
---|
System.String |
ComboBoxes
Gets inner combo boxes collection in the sheet. Read-only.
Declaration
public IComboBoxes ComboBoxes { get; }
Property Value
Type |
---|
IComboBoxes |
Comments
Gets a Comments collection that represents all the comments for the worksheet.
Declaration
public IComments Comments { get; }
Property Value
Type |
---|
IComments |
ContainsProtection
Inidicates whether protection should be serialized.
Declaration
protected virtual bool ContainsProtection { get; }
Property Value
Type |
---|
System.Boolean |
DefaultGridlineColor
Indicates whether gridline color has default value.
Declaration
public bool DefaultGridlineColor { get; set; }
Property Value
Type |
---|
System.Boolean |
DefaultProtectionOptions
Gets default protection options for the worksheet.
Declaration
protected abstract ExcelSheetProtection DefaultProtectionOptions { get; }
Property Value
Type |
---|
ExcelSheetProtection |
FirstColumn
Gets or sets one-based index of the first column of the worksheet.
Declaration
public virtual int FirstColumn { get; set; }
Property Value
Type |
---|
System.Int32 |
FirstRow
Gets or sets one-based index of the first row of the worksheet.
Declaration
public virtual int FirstRow { get; set; }
Property Value
Type |
---|
System.Int32 |
GridLineColor
Gets or sets the color of the Grid line in the worksheet.
Declaration
public ExcelKnownColors GridLineColor { get; set; }
Property Value
Type |
---|
ExcelKnownColors |
HasCharts
Indicates whether tabsheet has charts. Read-only.
Declaration
public bool HasCharts { get; }
Property Value
Type |
---|
System.Boolean |
HashValue
Hash value to ensure the sheet protected password.
Declaration
public byte[] HashValue { get; set; }
Property Value
Type |
---|
System.Byte[] |
HasPictures
Indicates whether tabsheet contains any picture. Read-only.
Declaration
public bool HasPictures { get; }
Property Value
Type |
---|
System.Boolean |
HasVmlShapes
Indicates whether worksheet has vml shapes. Read-only.
Declaration
public bool HasVmlShapes { get; }
Property Value
Type |
---|
System.Boolean |
HeaderFooterShapes
Header / footer shapes collection.
Declaration
public HeaderFooterShapeCollection HeaderFooterShapes { get; }
Property Value
Type |
---|
HeaderFooterShapeCollection |
Index
Gets the index number of the worksheet within the collection of worksheet. Read-only.
Declaration
public int Index { get; set; }
Property Value
Type |
---|
System.Int32 |
InnerCharts
Returns embedded charts collection. Read-only.
Declaration
protected WorksheetChartsCollection InnerCharts { get; }
Property Value
Type |
---|
WorksheetChartsCollection |
InnerCheckBoxes
Returns checkboxes collection for this sheet. Read-only.
Declaration
protected CheckBoxCollection InnerCheckBoxes { get; }
Property Value
Type |
---|
CheckBoxCollection |
InnerComments
Returns comments collection for this worksheet. Read-only.
Declaration
protected CommentsCollection InnerComments { get; }
Property Value
Type |
---|
CommentsCollection |
InnerHeaderFooterShapes
Header / footer shapes collection.
Declaration
public HeaderFooterShapeCollection InnerHeaderFooterShapes { get; }
Property Value
Type |
---|
HeaderFooterShapeCollection |
InnerPictures
Returns pictures collection. Read-only.
Declaration
protected PicturesCollection InnerPictures { get; }
Property Value
Type |
---|
PicturesCollection |
InnerProtection
Gets protected options. Read-only. For sets protection options use "Protect" method.
Declaration
protected virtual ExcelSheetProtection InnerProtection { get; }
Property Value
Type |
---|
ExcelSheetProtection |
InnerShapes
Returns shapes collection. Read-only.
Declaration
protected ShapesCollection InnerShapes { get; }
Property Value
Type |
---|
ShapesCollection |
InnerShapesBase
Returns InnerShapes base collection.
Declaration
public ShapeCollectionBase InnerShapesBase { get; }
Property Value
Type |
---|
ShapeCollectionBase |
IsParsed
Indicates whether object was parsed.
Declaration
public bool IsParsed { get; set; }
Property Value
Type |
---|
System.Boolean |
IsParsing
Indicates whether object is currently being parsed.
Declaration
public bool IsParsing { get; set; }
Property Value
Type |
---|
System.Boolean |
IsPasswordProtected
Gets a value indicating whether worksheet is protected with password.
Declaration
public bool IsPasswordProtected { get; }
Property Value
Type |
---|
System.Boolean |
IsRightToLeft
Indicates whether worksheet is displayed right to left.
Declaration
public bool IsRightToLeft { get; set; }
Property Value
Type |
---|
System.Boolean |
IsSaved
Indicates whether worksheet was saved.
Declaration
public bool IsSaved { get; set; }
Property Value
Type |
---|
System.Boolean |
IsSelected
Indicates whether tab of this sheet is selected. Read-only.
Declaration
public bool IsSelected { get; }
Property Value
Type |
---|
System.Boolean |
IsSkipParsing
Indicates whether worksheet was opened in skip parsing mode. Read-only.
Declaration
public bool IsSkipParsing { get; }
Property Value
Type |
---|
System.Boolean |
IsSupported
Indicates whether worksheet type is supported. Read-only.
Declaration
public bool IsSupported { get; protected set; }
Property Value
Type |
---|
System.Boolean |
IsTransitionEvaluation
Gets or sets IsTransitionEvaluation
Declaration
public bool IsTransitionEvaluation { get; set; }
Property Value
Type |
---|
System.Boolean |
LastColumn
Gets or sets one-based index of the last column of the worksheet.
Declaration
public virtual int LastColumn { get; set; }
Property Value
Type |
---|
System.Int32 |
LastRow
Gets or sets one-based index of the last row of the worksheet.
Declaration
public virtual int LastRow { get; set; }
Property Value
Type |
---|
System.Int32 |
LeftVisibleColumn
Gets or sets the left visible column of the worksheet.
Declaration
public int LeftVisibleColumn { get; set; }
Property Value
Type |
---|
System.Int32 |
Name
Returns or sets the name of the object. Read / write String.
Declaration
public string Name { get; set; }
Property Value
Type |
---|
System.String |
OptionButtons
Gets inner option buttons collection in the sheet. Read-only.
Declaration
public IOptionButtons OptionButtons { get; }
Property Value
Type |
---|
IOptionButtons |
PageSetupBase
Return page setup. Read-only.
Declaration
public abstract PageSetupBaseImpl PageSetupBase { get; }
Property Value
Type |
---|
PageSetupBaseImpl |
ParentWorkbook
Gets parent workbook. Read-only.
Declaration
public WorkbookImpl ParentWorkbook { get; }
Property Value
Type |
---|
WorkbookImpl |
ParseOnDemand
Gets or Sets a boolean value to parse worksheets on demand
Declaration
public bool ParseOnDemand { get; set; }
Property Value
Type |
---|
System.Boolean |
Pictures
Gets pictures collection in the worksheet. Read-only.
Declaration
public IPictures Pictures { get; }
Property Value
Type |
---|
IPictures |
ProtectContents
Indicates is current sheet is protected.
Declaration
public virtual bool ProtectContents { get; }
Property Value
Type |
---|
System.Boolean |
ProtectDrawingObjects
True if objects are protected. Read-only.
Declaration
public virtual bool ProtectDrawingObjects { get; }
Property Value
Type |
---|
System.Boolean |
Protection
Gets protected options. Read-only. To set protection options use "Protect" method.
Declaration
public virtual ExcelSheetProtection Protection { get; }
Property Value
Type |
---|
ExcelSheetProtection |
ProtectScenarios
True if the scenarios of the current sheet are protected. Read-only.
Declaration
public virtual bool ProtectScenarios { get; }
Property Value
Type |
---|
System.Boolean |
RealIndex
Index of the worksheet in the workbook (not necessary in Worksheets collection)
Declaration
public int RealIndex { get; set; }
Property Value
Type |
---|
System.Int32 |
SaltValue
Random generated Salt for the sheet password.
Declaration
public byte[] SaltValue { get; set; }
Property Value
Type |
---|
System.Byte[] |
Shapes
Gets shape collection in the worksheet.
Declaration
public IShapes Shapes { get; }
Property Value
Type |
---|
IShapes |
SheetProtection
Returns sheet protection record.
Declaration
protected SheetProtectionRecord SheetProtection { get; }
Property Value
Type |
---|
SheetProtectionRecord |
SpinCount
Spin count to loop the hash algorithm.
Declaration
public uint SpinCount { get; set; }
Property Value
Type |
---|
System.UInt32 |
TabColor
Gets or Sets Tab color.
Declaration
public virtual ExcelKnownColors TabColor { get; set; }
Property Value
Type |
---|
ExcelKnownColors |
TabColorObject
Gets Tab color object.
Declaration
public virtual ColorObject TabColorObject { get; }
Property Value
Type |
---|
ColorObject |
TabColorRGB
Gets or Sets Tab color RGB.
Declaration
public virtual Color TabColorRGB { get; set; }
Property Value
Type |
---|
System.Drawing.Color |
TextBoxes
Gets inner textboxes collection. Read-only.
Declaration
public ITextBoxes TextBoxes { get; }
Property Value
Type |
---|
ITextBoxes |
TopVisibleRow
Gets or sets the top visible row of the worksheet.
Declaration
public int TopVisibleRow { get; set; }
Property Value
Type |
---|
System.Int32 |
TypedCheckBoxes
Returns inner checkboxes collection. Read-only.
Declaration
public CheckBoxCollection TypedCheckBoxes { get; }
Property Value
Type |
---|
CheckBoxCollection |
TypedComboBoxes
Returns inner comboboxes collection. Read-only.
Declaration
public ComboBoxCollection TypedComboBoxes { get; }
Property Value
Type |
---|
ComboBoxCollection |
TypedOptionButtons
Returns inner checkboxes collection. Read-only.
Declaration
public OptionButtonCollection TypedOptionButtons { get; }
Property Value
Type |
---|
OptionButtonCollection |
TypedTextBoxes
Gets inner textboxes collection. Read-only.
Declaration
public TextBoxCollection TypedTextBoxes { get; }
Property Value
Type |
---|
TextBoxCollection |
UnknownVmlShapes
Indicates whether worksheet contains some unknown vml shapes.
Declaration
public bool UnknownVmlShapes { get; set; }
Property Value
Type |
---|
System.Boolean |
UnprotectedOptions
Returnd unprotected options
Declaration
protected virtual ExcelSheetProtection UnprotectedOptions { get; }
Property Value
Type |
---|
ExcelSheetProtection |
Visibility
Controls end user visibility of worksheet.
Declaration
public WorksheetVisibility Visibility { get; set; }
Property Value
Type |
---|
WorksheetVisibility |
VmlShapesCount
Returns number of known vml shapes. Read-only.
Declaration
public int VmlShapesCount { get; }
Property Value
Type |
---|
System.Int32 |
WindowTwo
Sheet window settings.
Declaration
public WindowTwoRecord WindowTwo { get; }
Property Value
Type |
---|
WindowTwoRecord |
Workbook
Get parent workbook of current worksheet.
Declaration
public IWorkbook Workbook { get; }
Property Value
Type |
---|
IWorkbook |
Zoom
Gets or sets the value that represents zoom factor of document. Value must be in range from 10 till 400.
Declaration
public int Zoom { get; set; }
Property Value
Type |
---|
System.Int32 |
Methods
Activate()
Makes the current sheet the active sheet.
Declaration
public virtual void Activate()
Remarks
Calling this method is equivalent to clicking the sheet's tab in MS Excel.
add_NameChanged(ValueChangedEventHandler)
Declaration
public void add_NameChanged(ValueChangedEventHandler value)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Implementation.ValueChangedEventHandler | value |
ClearAll(ExcelWorksheetCopyFlags)
Clear all internal collections but excluding mentioned flags.
Declaration
protected virtual void ClearAll(ExcelWorksheetCopyFlags flags)
Parameters
Type | Name | Description |
---|---|---|
ExcelWorksheetCopyFlags | flags | Allows to avoid clearing of some properties. |
Clone(Object)
Creates copy of the current object.
Declaration
public virtual object Clone(object parent)
Parameters
Type | Name | Description |
---|---|---|
System.Object | parent | Parent object for the new object. |
Returns
Type | Description |
---|---|
System.Object | Copy of the current object. |
Clone(Object, Boolean)
Creates copy of the current object and indicates whether we should copy the shapes or not.
Declaration
public virtual object Clone(object parent, bool cloneShapes)
Parameters
Type | Name | Description |
---|---|---|
System.Object | parent | Parent object for the new object. |
System.Boolean | cloneShapes | Indicates whether we should clone shapes or not. |
Returns
Type | Description |
---|---|
System.Object | Copy of the current object and indicates whether we should copy the shapes or not |
CloneShapes(WorksheetBaseImpl)
Create copy of the shapes collection inside specified worksheet object.
Declaration
public void CloneShapes(WorksheetBaseImpl result)
Parameters
Type | Name | Description |
---|---|---|
WorksheetBaseImpl | result | Object to put shapes into. |
CombineArrays(Int32, List<Byte[]>)
Combines several byte arrays into one.
Declaration
public static byte[] CombineArrays(int iCombinedLength, List<byte[]> arrCombined)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | iCombinedLength | Size of the combined data. |
System.Collections.Generic.List<System.Byte[]> | arrCombined | List that contains byte arrays to combine. |
Returns
Type | Description |
---|---|
System.Byte[] | Combined array. |
CopyFrom(WorksheetBaseImpl, Dictionary<String, String>, Dictionary<String, String>, Dictionary<Int32, Int32>, ExcelWorksheetCopyFlags, Dictionary<Int32, Int32>)
Copies all data from another worksheet.
Declaration
public void CopyFrom(WorksheetBaseImpl worksheet, Dictionary<string, string> hashStyleNames, Dictionary<string, string> hashWorksheetNames, Dictionary<int, int> dicFontIndexes, ExcelWorksheetCopyFlags flags, Dictionary<int, int> hashExtFormatIndexes)
Parameters
Type | Name | Description |
---|---|---|
WorksheetBaseImpl | worksheet | Parent worksheet. |
System.Collections.Generic.Dictionary<System.String, System.String> | hashStyleNames | Dictionary with style names. |
System.Collections.Generic.Dictionary<System.String, System.String> | hashWorksheetNames | Dictionary with new worksheet names. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | dicFontIndexes | Dictionary with new font indexes. |
ExcelWorksheetCopyFlags | flags | Copy flags. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | hashExtFormatIndexes | Dictionary with extended format indexes, key - old index, value - new index. |
CopyHeaderFooterImages(WorksheetBaseImpl, Dictionary<String, String>, IDictionary)
Copies preserved header/footer images.
Declaration
protected void CopyHeaderFooterImages(WorksheetBaseImpl sourceSheet, Dictionary<string, string> hashNewNames, IDictionary dicFontIndexes)
Parameters
Type | Name | Description |
---|---|---|
WorksheetBaseImpl | sourceSheet | Source worksheet. |
System.Collections.Generic.Dictionary<System.String, System.String> | hashNewNames | Hash with new WorkSheet names. |
System.Collections.IDictionary | dicFontIndexes | Dictionary with new font indexes. |
CopyOptions(WorksheetBaseImpl)
Copies different sheet options.
Declaration
protected virtual void CopyOptions(WorksheetBaseImpl sourceSheet)
Parameters
Type | Name | Description |
---|---|---|
WorksheetBaseImpl | sourceSheet | Source sheet. |
CopyShapes(WorksheetBaseImpl, Dictionary<String, String>, Dictionary<Int32, Int32>)
Copies all shapes from a source worksheet.
Declaration
protected void CopyShapes(WorksheetBaseImpl sourceSheet, Dictionary<string, string> hashNewNames, Dictionary<int, int> dicFontIndexes)
Parameters
Type | Name | Description |
---|---|---|
WorksheetBaseImpl | sourceSheet | Source worksheet. |
System.Collections.Generic.Dictionary<System.String, System.String> | hashNewNames | Hash with new WorkSheet names. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | dicFontIndexes | Dictionary with new font indexes. |
CreateSalt(Int32)
Creates random salt.
Declaration
protected byte[] CreateSalt(int length)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | length | Desired salt length. |
Returns
Type | Description |
---|---|
System.Byte[] | Array with random data. |
Dispose()
Dispose
Declaration
public override void Dispose()
Overrides
ExtractMSODrawing(Int32, ExcelParseOptions)
Extracts MsoDrawing records from internal array.
Declaration
protected void ExtractMSODrawing(int startIndex, ExcelParseOptions options)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | startIndex | Index to the first MsoDrawing record. |
ExcelParseOptions | options | Parse options. |
FindParents()
Searches for all necessary parent objects.
Declaration
protected virtual void FindParents()
GetPasswordHash(String)
Returns hash value for the password string.
Declaration
public static ushort GetPasswordHash(string password)
Parameters
Type | Name | Description |
---|---|---|
System.String | password | Password to hash. |
Returns
Type | Description |
---|---|
System.UInt16 | Hash value for the password string. |
InitializeCollections()
Initializes all required collections.
Declaration
protected virtual void InitializeCollections()
MarkUsedReferences(Boolean[])
Sets items with used reference indexes to true.
Declaration
public abstract void MarkUsedReferences(bool[] usedItems)
Parameters
Type | Name | Description |
---|---|---|
System.Boolean[] | usedItems | Array to mark used references in. |
OnNameChanged(ValueChangedEventArgs)
This method is called when Name of the worksheet was changed.
Declaration
protected virtual void OnNameChanged(ValueChangedEventArgs args)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Implementation.ValueChangedEventArgs | args | Event arguments. |
OnRealIndexChanged(Int32)
This method is called after RealIndex property change.
Declaration
protected virtual void OnRealIndexChanged(int iOldIndex)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | iOldIndex | Old index. |
Parse()
Parses internal records.
Declaration
public virtual void Parse()
Parse(BiffReader, ExcelParseOptions, Boolean, Dictionary<Int32, Int32>, IDecryptor)
Method extracts biff records belonging to the worksheet.
Declaration
protected void Parse(BiffReader reader, ExcelParseOptions options, bool bSkipParsing, Dictionary<int, int> hashNewXFormatIndexes, IDecryptor decryptor)
Parameters
Type | Name | Description |
---|---|---|
BiffReader | reader | BiffReader that contains worksheet's records. |
ExcelParseOptions | options | Parse options. |
System.Boolean | bSkipParsing | Indicates whether to skip parsing. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | hashNewXFormatIndexes | Dictionary with new extended format indexes for ignore styles mode. |
IDecryptor | decryptor | Object used to decrypt encrypted records. |
ParseData()
Parses worksheet's data.
Declaration
protected void ParseData()
ParseData(Dictionary<Int32, Int32>)
Parses worksheet's data.
Declaration
protected abstract void ParseData(Dictionary<int, int> dictUpdatedSSTIndexes)
Parameters
Type | Name | Description |
---|---|---|
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | dictUpdatedSSTIndexes |
ParseDimensions(DimensionsRecord)
Parses dimensions record.
Declaration
protected virtual void ParseDimensions(DimensionsRecord dimensions)
Parameters
Type | Name | Description |
---|---|---|
DimensionsRecord | dimensions | Record to parse. |
ParseNextRecord(BiffReader, Int32, ExcelParseOptions, Boolean, Dictionary<Int32, Int32>, IDecryptor)
Extracts next record from reader and parses it.
Declaration
protected virtual int ParseNextRecord(BiffReader reader, int iBOFCounter, ExcelParseOptions options, bool bSkipStyles, Dictionary<int, int> hashNewXFormatIndexes, IDecryptor decryptor)
Parameters
Type | Name | Description |
---|---|---|
BiffReader | reader | Reader to extract record from. |
System.Int32 | iBOFCounter | Number of BOF records without closing EOF record. |
ExcelParseOptions | options | Parsing options. |
System.Boolean | bSkipStyles | Indicates whether styles information must be skipped. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | hashNewXFormatIndexes | Dictionary with new extended format indexes for ignore styles mode. |
IDecryptor | decryptor | Object used to decrypt encrypted records. |
Returns
Type | Description |
---|---|
System.Int32 | Updated number of BOF records without closing EOF record. |
ParseObjectProtect(ObjectProtectRecord)
Parse ObjectProtect record.
Declaration
protected void ParseObjectProtect(ObjectProtectRecord objectProtect)
Parameters
Type | Name | Description |
---|---|---|
ObjectProtectRecord | objectProtect | Record to parse. |
ParsePassword(PasswordRecord)
Parses Password record.
Declaration
protected void ParsePassword(PasswordRecord passwordRecord)
Parameters
Type | Name | Description |
---|---|---|
PasswordRecord | passwordRecord | Record to parse. |
ParseProtect(ProtectRecord)
Parses Protect record.
Declaration
protected void ParseProtect(ProtectRecord protectRecord)
Parameters
Type | Name | Description |
---|---|---|
ProtectRecord | protectRecord | Record to parse. |
ParseRecord(BiffRecordRaw, Boolean, Dictionary<Int32, Int32>)
Parses single record.
Declaration
protected virtual void ParseRecord(BiffRecordRaw raw, bool bIgnoreStyles, Dictionary<int, int> hashNewXFormatIndexes)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw | raw | Record to parse. |
System.Boolean | bIgnoreStyles | Indicates whether to ignore styles. |
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | hashNewXFormatIndexes | Dictionary with new extended format indexes for ignore styles mode. |
ParseScenProtect(ScenProtectRecord)
Parse ScenProtect record.
Declaration
protected void ParseScenProtect(ScenProtectRecord scenProtect)
Parameters
Type | Name | Description |
---|---|---|
ScenProtectRecord | scenProtect | Record to parse. |
ParseSheetLayout(SheetLayoutRecord)
Parses sheet layout record.
Declaration
protected void ParseSheetLayout(SheetLayoutRecord sheetLayout)
Parameters
Type | Name | Description |
---|---|---|
SheetLayoutRecord | sheetLayout | Record to parse. |
ParseWindowTwo(WindowTwoRecord)
Parse WindowTwo record.
Declaration
protected virtual void ParseWindowTwo(WindowTwoRecord windowTwo)
Parameters
Type | Name | Description |
---|---|---|
WindowTwoRecord | windowTwo | Record to parse. |
ParseWindowZoom(WindowZoomRecord)
Parses WindowZoom record.
Declaration
protected virtual void ParseWindowZoom(WindowZoomRecord windowZoom)
Parameters
Type | Name | Description |
---|---|---|
WindowZoomRecord | windowZoom | Record to parse. |
PrepareProtection()
Prepares protection variables.
Declaration
protected void PrepareProtection()
PrepareProtectionOptions(ExcelSheetProtection)
Prepares protection options before setting protection.
Declaration
protected virtual ExcelSheetProtection PrepareProtectionOptions(ExcelSheetProtection options)
Parameters
Type | Name | Description |
---|---|---|
ExcelSheetProtection | options |
Returns
Type |
---|
ExcelSheetProtection |
PrepareVariables(ExcelParseOptions, Boolean)
Prepares variables to worksheet parsing.
Declaration
protected virtual void PrepareVariables(ExcelParseOptions options, bool bSkipParsing)
Parameters
Type | Name | Description |
---|---|---|
ExcelParseOptions | options | Parse options. |
System.Boolean | bSkipParsing | Indicates whether to skip parsing. |
Protect(String)
Protects worksheet with password.
Declaration
public void Protect(string password)
Parameters
Type | Name | Description |
---|---|---|
System.String | password | Protection password. |
Exceptions
Type | Condition |
---|---|
System.ApplicationException | If worksheet is already protected. |
System.ArgumentNullException | If specified password is null. |
System.ArgumentOutOfRangeException | If length of the password is more than 15 symbols. |
Protect(String, ExcelSheetProtection)
Protects current worksheet.
Declaration
public void Protect(string password, ExcelSheetProtection options)
Parameters
Type | Name | Description |
---|---|---|
System.String | password | Represents password to protect. |
ExcelSheetProtection | options | Represents params to protect. |
RaiseNameChangedEvent(ValueChangedEventArgs)
This method raises NameChanged event.
Declaration
protected void RaiseNameChangedEvent(ValueChangedEventArgs args)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Implementation.ValueChangedEventArgs | args | Event arguments. |
remove_NameChanged(ValueChangedEventHandler)
Declaration
public void remove_NameChanged(ValueChangedEventHandler value)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Implementation.ValueChangedEventHandler | value |
Round(Int32, Int32)
Rounds value.
Declaration
public static int Round(int value, int degree)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | value | Value to be rounded. |
System.Int32 | degree | Represents degree used to round the given value. |
Returns
Type | Description |
---|---|
System.Int32 | Rounded value. |
Select()
Selects current tab sheet.
Declaration
public virtual void Select()
SelectTab()
Adds sheet tab to the selected tab.
Declaration
public void SelectTab()
Serialize(OffsetArrayList)
Serializes records.
Declaration
public virtual void Serialize(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | Records to be serialized. |
SerializeHeaderFooterPictures(OffsetArrayList)
Serializes header / footer pictures.
Declaration
protected virtual void SerializeHeaderFooterPictures(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializeMacrosSupport(OffsetArrayList)
Serializes macros support.
Declaration
protected virtual void SerializeMacrosSupport(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializeMsoDrawings(OffsetArrayList)
Saves all shapes.
Declaration
protected virtual void SerializeMsoDrawings(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializePageLayoutView(OffsetArrayList)
Serializes page layout view
Declaration
protected virtual void SerializePageLayoutView(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializeProtection(OffsetArrayList, Boolean)
Saves protection block.
Declaration
protected virtual void SerializeProtection(OffsetArrayList records, bool bContentNotNecessary)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
System.Boolean | bContentNotNecessary |
SerializeSheetLayout(OffsetArrayList)
Serializes sheet layout record.
Declaration
protected void SerializeSheetLayout(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializeSheetProtection(OffsetArrayList)
Serialize sheet protection.
Declaration
protected void SerializeSheetProtection(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | Represents record storage. |
SerializeWindowTwo(OffsetArrayList)
Serializes WindowTwo record.
Declaration
protected virtual void SerializeWindowTwo(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SerializeWindowZoom(OffsetArrayList)
Serializes WindowZoom.
Declaration
protected void SerializeWindowZoom(OffsetArrayList records)
Parameters
Type | Name | Description |
---|---|---|
OffsetArrayList | records | List to save records into. |
SetChanged()
This method should be called after any changes in the worksheet. Sets Saved property of the parent workbook to false.
Declaration
public void SetChanged()
Unprotect()
Unprotects this worksheet without password.
Declaration
public void Unprotect()
Unprotect(String)
Unprotects this worksheet using specified password.
Declaration
public void Unprotect(string password)
Parameters
Type | Name | Description |
---|---|---|
System.String | password | Password to unprotect. |
Unselect()
Unselects current tab sheet if possible.
Declaration
public void Unselect()
Unselect(Boolean)
Unselects current tab sheet if possible.
Declaration
public void Unselect(bool bCheckNumber)
Parameters
Type | Name | Description |
---|---|---|
System.Boolean | bCheckNumber | Indicates whether to allow unselect last sheet. |
UpdateExtendedFormatIndex(Dictionary<Int32, Int32>)
This method should be called immediately after extended format removal.
Declaration
public virtual void UpdateExtendedFormatIndex(Dictionary<int, int> dictFormats)
Parameters
Type | Name | Description |
---|---|---|
System.Collections.Generic.Dictionary<System.Int32, System.Int32> | dictFormats | Dictionary with updated extended formats. |
UpdateFormula(Int32, Int32, Rectangle, Int32, Rectangle)
Updates formulas after copy operation.
Declaration
public virtual void UpdateFormula(int iCurIndex, int iSourceIndex, Rectangle sourceRect, int iDestIndex, Rectangle destRect)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | iCurIndex | Current worksheet index. |
System.Int32 | iSourceIndex | Source worksheet index. |
System.Drawing.Rectangle | sourceRect | Source rectangle. |
System.Int32 | iDestIndex | Destination worksheet index. |
System.Drawing.Rectangle | destRect | Destination rectangle. |
UpdateReferenceIndexes(Int32[])
Updates reference indexes.
Declaration
public abstract void UpdateReferenceIndexes(int[] arrUpdatedIndexes)
Parameters
Type | Name | Description |
---|---|---|
System.Int32[] | arrUpdatedIndexes | Array with updated indexes. |
UpdateStyleIndexes(Int32[])
Updates style indexes.
Declaration
protected virtual void UpdateStyleIndexes(int[] styleIndexes)
Parameters
Type | Name | Description |
---|---|---|
System.Int32[] | styleIndexes | Array with changed style indexes. |
Events
NameChanged
This event is raised when name of the worksheet is changed.
Declaration
public event ValueChangedEventHandler NameChanged
Event Type
Type |
---|
Syncfusion.XlsIO.Implementation.ValueChangedEventHandler |
Explicit Interface Implementations
ITabSheet.TabIndex
Returns index in the parent ITabSheets collection. Read-only.
Declaration
int ITabSheet.TabIndex { get; }
Returns
Type |
---|
System.Int32 |