HtmlLoadOptions

HtmlLoadOptions class

Represents options when importing a html file.

Constructors

NameDescription
HtmlLoadOptionsCreates an options of loading the file.
HtmlLoadOptionsCreates an options of loading the file.

Properties

NameTypeDescription
AttachedFilesDirectoryStringThe directory that the attached files will be saved to. NOTE: This member is now obsolete. Instead, please use HtmlLoadO
LoadFormulasbooleanIndicates whether importing formulas if the original html file contains formulas
SupportDivTagbooleanIndicates whether support the layout of
tag when the html file contains it. The default value is false.
DeleteRedundantSpacesbooleanIndicates whether delete redundant spaces when the text wraps lines using
tag. The default value is false.
AutoFitColsAndRowsbooleanIndicates whether auto-fit columns and rows. The default value is false.
ConvertFormulasDatabooleanif true, convert string to formula when string value starts with character ‘=’,the default value is false. NOTE: This pr
HasFormulabooleanIndicates whether the text is formula if it starts with “=”.
ProgIdStringGets the program id of creating the file. Only for MHT files.
TableLoadOptionsHtmlTableLoadOptionCollectionGet the HtmlTableLoadOptionCollection instance
DetectLaTeXboolean
ParagrahLayoutModeintThe value of the property is HtmlParagraphLayoutMode integer constant.
HyperlinkLoadModeintThe value of the property is HyperlinkLoadMode integer constant.
EncodingEncodingGets and sets the default encoding. Only applies for csv file.
LoadStyleStrategyintIndicates the strategy to apply style for parsed values when converting string value to number or datetime. The value of
ConvertNumericDatabooleanGets or sets a value that indicates whether the string in text file is converted to numeric data.
ConvertDateTimeDatabooleanGets or sets a value that indicates whether the string in text file is converted to date data.
KeepPrecisionbooleanIndicates whether not parsing a string value if the length is 15.
LoadFormatintGets the load format. The value of the property is LoadFormat integer constant.
PasswordStringGets and set the password of the workbook.
ParsingFormulaOnOpenbooleanIndicates whether parsing the formula when reading the file. Only applies for Excel Xlsx, Xltx, Xltm and Xlsm file becau
ParsingPivotCachedRecordsbooleanIndicates whether parsing pivot cached records when loading the file. The default value is false. Only applies for Excel
LanguageCodeintGets or sets the user interface language of the Workbook version based on CountryCode that has saved the file. The value
RegionintGets or sets the system regional settings based on CountryCode at the time the file was loaded. The value of the propert
LocaleLocaleGets and sets the Locale used for workbook at the time the file was loaded.
DefaultStyleSettingsDefaultStyleSettingsGets the default style settings for initializing styles of the workbook
StandardFontStringSets the default standard font name NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This pr
StandardFontSizefloatSets the default standard font size. NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This p
InterruptMonitorAbstractInterruptMonitorGets and sets the interrupt monitor.
IgnoreNotPrintedbooleanIgnore the data which are not printed if directly printing the file Only for xlsx file.
CheckDataValidbooleanCheck whether data is valid in the template file.
CheckExcelRestrictionbooleanWhether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputt
KeepUnparsedDatabooleanWhether keep the unparsed data in memory for the Workbook when it is loaded from template file. Default is true. For sce
LoadFilterLoadFilterThe filter to denote how to load data.
LightCellsDataHandlerLightCellsDataHandlerThe data handler for processing cells data when reading template file.
MemorySettingintGets or sets the memory usage options. The value of the property is MemorySetting integer constant.
WarningCallbackIWarningCallbackGets or sets warning callback.
AutoFitterOptionsAutoFitterOptionsGets and sets the auto fitter options Only for xlsx ,spreadsheetML file now.
AutoFilterbooleanIndicates whether auto filtering the data when loading the files. Sometimes although autofilter is set, the correspondin
FontConfigsIndividualFontConfigsGets and sets individual font configs. Only works for the Workbook which uses this LoadOptions to load.
IgnoreUselessShapesbooleanIndicates whether ignoring useless shapes. Only works for xlsx,xlsb, and xlsm files. There are many overlapping identica
PreservePaddingSpacesInFormulabooleanIndicates whether preserve those spaces and line breaks that are padded between formula tokens while getting and setting

Methods

NameDescription
setPaperSizeSets the default print paper size from default printer’s setting.

If there is no setting about paper size,MS Excel will |

HtmlLoadOptions() (1 of 2)

Creates an options of loading the file.


HtmlLoadOptions(loadFormat) (2 of 2)

Creates an options of loading the file.

ParameterTypeDescription
loadFormatintA LoadFormat value. The loading format.

HtmlLoadOptions.AttachedFilesDirectory property

The directory that the attached files will be saved to. NOTE: This member is now obsolete. Instead, please use HtmlLoadOptions.StreamProvider property. This property will be removed 12 months later since December 2014. Aspose apologizes for any inconvenience you may have experienced.

Type: String

HtmlLoadOptions.LoadFormulas property

Indicates whether importing formulas if the original html file contains formulas

Type: boolean

HtmlLoadOptions.SupportDivTag property

Indicates whether support the layout of

tag when the html file contains it. The default value is false.

Type: boolean

HtmlLoadOptions.DeleteRedundantSpaces property

Indicates whether delete redundant spaces when the text wraps lines using
tag. The default value is false.

Type: boolean

HtmlLoadOptions.AutoFitColsAndRows property

Indicates whether auto-fit columns and rows. The default value is false.

Type: boolean

HtmlLoadOptions.ConvertFormulasData property

if true, convert string to formula when string value starts with character ‘=’,the default value is false. NOTE: This property is now obsolete. Instead, please use HtmlLoadOptions.HasFormula property. This property will be removed 12 months later since March 2023. Aspose apologizes for any inconvenience you may have experienced.

Type: boolean

HtmlLoadOptions.HasFormula property

Indicates whether the text is formula if it starts with “=”.

Type: boolean

HtmlLoadOptions.ProgId property

Gets the program id of creating the file. Only for MHT files.

Type: String

HtmlLoadOptions.TableLoadOptions property

Get the HtmlTableLoadOptionCollection instance

Type: HtmlTableLoadOptionCollection

HtmlLoadOptions.DetectLaTeX property

Type: boolean

HtmlLoadOptions.ParagrahLayoutMode property

The value of the property is HtmlParagraphLayoutMode integer constant.

Type: int

HtmlLoadOptions.HyperlinkLoadMode property

The value of the property is HyperlinkLoadMode integer constant.

Type: int

HtmlLoadOptions.Encoding property

Gets and sets the default encoding. Only applies for csv file.

Type: Encoding

HtmlLoadOptions.LoadStyleStrategy property

Indicates the strategy to apply style for parsed values when converting string value to number or datetime. The value of the property is TxtLoadStyleStrategy integer constant.

Type: int

HtmlLoadOptions.ConvertNumericData property

Gets or sets a value that indicates whether the string in text file is converted to numeric data.

Type: boolean

HtmlLoadOptions.ConvertDateTimeData property

Gets or sets a value that indicates whether the string in text file is converted to date data.

Type: boolean

HtmlLoadOptions.KeepPrecision property

Indicates whether not parsing a string value if the length is 15.

Type: boolean

HtmlLoadOptions.LoadFormat property

Gets the load format. The value of the property is LoadFormat integer constant.

Type: int

HtmlLoadOptions.Password property

Gets and set the password of the workbook.

Type: String

HtmlLoadOptions.ParsingFormulaOnOpen property

Indicates whether parsing the formula when reading the file. Only applies for Excel Xlsx, Xltx, Xltm and Xlsm file because the formulas in the files are stored with a string formula.

Type: boolean

HtmlLoadOptions.ParsingPivotCachedRecords property

Indicates whether parsing pivot cached records when loading the file. The default value is false. Only applies for Excel Xlsx, Xltx, Xltm , Xlsm and xlsb file

Type: boolean

HtmlLoadOptions.LanguageCode property

Gets or sets the user interface language of the Workbook version based on CountryCode that has saved the file. The value of the property is CountryCode integer constant.

Type: int

HtmlLoadOptions.Region property

Gets or sets the system regional settings based on CountryCode at the time the file was loaded. The value of the property is CountryCode integer constant. If you do not want to use the region saved in the file, please reset it after reading the file.

Type: int

HtmlLoadOptions.Locale property

Gets and sets the Locale used for workbook at the time the file was loaded.

Type: Locale

HtmlLoadOptions.DefaultStyleSettings property

Gets the default style settings for initializing styles of the workbook

Type: DefaultStyleSettings

HtmlLoadOptions.StandardFont property

Sets the default standard font name NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This property will be removed 12 months later since March 2022. Aspose apologizes for any inconvenience you may have experienced.

Type: String

HtmlLoadOptions.StandardFontSize property

Sets the default standard font size. NOTE: This member is now obsolete. Instead, please use DefaultStyleSettings. This property will be removed 12 months later since March 2022. Aspose apologizes for any inconvenience you may have experienced.

Type: float

HtmlLoadOptions.InterruptMonitor property

Gets and sets the interrupt monitor.

Type: AbstractInterruptMonitor

HtmlLoadOptions.IgnoreNotPrinted property

Ignore the data which are not printed if directly printing the file Only for xlsx file.

Type: boolean

HtmlLoadOptions.CheckDataValid property

Check whether data is valid in the template file.

Type: boolean

HtmlLoadOptions.CheckExcelRestriction property

Whether check restriction of excel file when user modify cells related objects. For example, excel does not allow inputting string value longer than 32K. When you input a value longer than 32K such as by Cell.PutValue(string), if this property is true, you will get an Exception. If this property is false, we will accept your input string value as the cell’s value so that later you can output the complete string value for other file formats such as CSV. However, if you have set such kind of value that is invalid for excel file format, you should not save the workbook as excel file format later. Otherwise there may be unexpected error for the generated excel file.

Type: boolean

HtmlLoadOptions.KeepUnparsedData property

Whether keep the unparsed data in memory for the Workbook when it is loaded from template file. Default is true. For scenarios that user only needs to read some contents from template file and does not need to save the workbook back, set this property as false may improve performance, especially when using it together with some kind of LoadFilter,

Type: boolean

HtmlLoadOptions.LoadFilter property

The filter to denote how to load data.

Type: LoadFilter

HtmlLoadOptions.LightCellsDataHandler property

The data handler for processing cells data when reading template file.

Type: LightCellsDataHandler

HtmlLoadOptions.MemorySetting property

Gets or sets the memory usage options. The value of the property is MemorySetting integer constant.

Type: int

HtmlLoadOptions.WarningCallback property

Gets or sets warning callback.

Type: IWarningCallback

HtmlLoadOptions.AutoFitterOptions property

Gets and sets the auto fitter options Only for xlsx ,spreadsheetML file now.

Type: AutoFitterOptions

HtmlLoadOptions.AutoFilter property

Indicates whether auto filtering the data when loading the files. Sometimes although autofilter is set, the corresponding rows is not hidden in the file. Now only works for SpreadSheetML file.

Type: boolean

HtmlLoadOptions.FontConfigs property

Gets and sets individual font configs. Only works for the Workbook which uses this LoadOptions to load.

Type: IndividualFontConfigs

HtmlLoadOptions.IgnoreUselessShapes property

Indicates whether ignoring useless shapes. Only works for xlsx,xlsb, and xlsm files. There are many overlapping identical shapes which are useless in some files, we can ingore them when loading files.

Type: boolean

HtmlLoadOptions.PreservePaddingSpacesInFormula property

Indicates whether preserve those spaces and line breaks that are padded between formula tokens while getting and setting formulas. Default value is false. After loading workbook from template file with this option, FormulaSettings.PreservePaddingSpaces will be set to the same value with this property.

Type: boolean

setPaperSize(type)

Sets the default print paper size from default printer’s setting.

If there is no setting about paper size,MS Excel will use default printer’s setting.

ParameterTypeDescription
typeintA PaperSizeType value. The default paper size.