HtmlLoadOptions

HtmlLoadOptions class

Позволяет указать дополнительные параметры при загрузке HTML-документа вDocument объект.

Чтобы узнать больше, посетитеУкажите параметры загрузки документальная статья.

public class HtmlLoadOptions : LoadOptions

Конструкторы

ИмяОписание
HtmlLoadOptions()Инициализирует новый экземпляр этого класса со значениями по умолчанию.
HtmlLoadOptions(string)Ярлык для инициализации нового экземпляра этого класса с указанным паролем для загрузки зашифрованного документа.
HtmlLoadOptions(LoadFormat, string, string)Ярлык для инициализации нового экземпляра этого класса со свойствами, установленными на указанные значения.

Характеристики

ИмяОписание
BaseUri { get; set; }Возвращает или задает строку, которая будет использоваться для преобразования относительных URI, найденных в документе, в абсолютные URI при необходимости. Может бытьнулевой или пустая строка. По умолчаниюнулевой .
BlockImportMode { get; set; }Возвращает или задает значение, указывающее, как импортируются свойства элементов уровня блока. Значение по умолчанию:Merge .
ConvertMetafilesToPng { get; set; }Возвращает или задает, следует ли преобразовывать метафайл (Wmf илиEmf ) изображения вPngформат изображения.
ConvertShapeToOfficeMath { get; set; }Возвращает или задает, следует ли преобразовывать фигуры с EquationXML в объекты Office Math.
ConvertSvgToEmf { get; set; }Возвращает или задает значение, указывающее, следует ли преобразовывать загруженные изображения SVG в формат EMF. Значение по умолчанию:ЛОЖЬ и, если возможно, загруженные SVG-изображения сохраняются как есть без конвертации.
Encoding { get; set; }Возвращает или задает кодировку, которая будет использоваться для загрузки документа HTML, TXT или CHM, если кодировка не указана внутри документа. Может бытьнулевой . По умолчаниюнулевой .
FontSettings { get; set; }Позволяет указать настройки шрифта документа.
IgnoreNoscriptElements { get; set; }Возвращает или задает значение, указывающее, следует ли игнорировать элементы HTML <noscript>. Значение по умолчанию:ЛОЖЬ .
IgnoreOleData { get; set; }Указывает, следует ли игнорировать данные OLE.
LanguagePreferences { get; }Получает языковые настройки, которые будут использоваться при загрузке документа.
LoadFormat { get; set; }Указывает формат документа для загрузки. Значение по умолчанию:Auto .
MswVersion { get; set; }Позволяет указать, что процесс загрузки документа должен соответствовать определенной версии MS Word. Значение по умолчанию:Word2019
Password { get; set; }Возвращает или задает пароль для открытия зашифрованного документа. Может бытьнулевой или пустая строка. По умолчаниюнулевой .
PreferredControlType { get; set; }Возвращает или задает предпочтительный тип узлов документа, которые будут представлять импортированные элементы <input> и <select>. Значение по умолчанию:FormField .
PreserveIncludePictureField { get; set; }Возвращает или задает, следует ли сохранять поле INCLUDEPICTURE при чтении форматов Microsoft Word. Значение по умолчанию:ЛОЖЬ .
ProgressCallback { get; set; }Вызывается во время загрузки документа и принимает данные о ходе загрузки.
ResourceLoadingCallback { get; set; }Позволяет контролировать загрузку внешних ресурсов (изображений, таблиц стилей) при импорте документа из HTML, MHTML.
SupportFontFaceRules { get; set; }Возвращает или задает значение, указывающее, следует ли поддерживать правила @font-face и загружать ли объявленные шрифты. Значение по умолчанию:ЛОЖЬ .
SupportVml { get; set; }Возвращает или задает значение, указывающее, следует ли поддерживать изображения VML.
TempFolder { get; set; }Позволяет использовать временные файлы при чтении документа. По умолчанию это свойствонулевой и временные файлы не используются.
UpdateDirtyFields { get; set; }Указывает, следует ли обновлять поля с помощьюгрязный атрибут.
UseSystemLcid { get; set; }Возвращает или задает, следует ли использовать значение LCID, полученное из реестра Windows, для определения полей страницы по умолчанию.
WarningCallback { get; set; }Вызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.
WebRequestTimeout { get; set; }Количество миллисекунд ожидания до тайм-аута веб-запроса. Значение по умолчанию — 100000 миллисекунд (100 секунд).

Методы

ИмяОписание
override Equals(object)Определяет, равен ли указанный объект по значению текущему объекту.

Примеры

Показывает, как поддерживать условные комментарии при загрузке HTML-документа.

HtmlLoadOptions loadOptions = new HtmlLoadOptions();

// Если значение равно true, то мы учитываем код VML при анализе загруженного документа.
loadOptions.SupportVml = supportVml;

// Этот документ содержит изображение JPEG в тегах "<!--[if gte vml 1]>",
// и другое изображение PNG в тегах "<![if !vml]>".
// Если установить флаг «SupportVml» на «true», то Aspose.Words загрузит JPEG.
// Если мы установим этот флаг на «false», то Aspose.Words загрузит только PNG.
Document doc = new Document(MyDir + "VML conditional.htm", loadOptions);

if (supportVml)
    Assert.AreEqual(ImageType.Jpeg, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).ImageData.ImageType);
else
    Assert.AreEqual(ImageType.Png, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).ImageData.ImageType);

Смотрите также

HtmlControlType Enum IDocumentLoadingCallback Interface