LoadOptions

LoadOptions class

Позволяет указать дополнительные параметры (например, пароль или базовый URI) при загрузке документа вDocument объект.

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

public class LoadOptions

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

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

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

ИмяОписание
BaseUri { get; set; }Возвращает или задает строку, которая будет использоваться для преобразования относительных URI, найденных в документе, в абсолютные URI при необходимости. Может бытьнулевой или пустая строка. По умолчаниюнулевой .
ConvertMetafilesToPng { get; set; }Возвращает или задает, следует ли преобразовывать метафайл (Wmf илиEmf ) изображения вPngформат изображения.
ConvertShapeToOfficeMath { get; set; }Возвращает или задает, следует ли преобразовывать фигуры с EquationXML в объекты Office Math.
Encoding { get; set; }Возвращает или задает кодировку, которая будет использоваться для загрузки документа HTML, TXT или CHM, если кодировка не указана внутри документа. Может бытьнулевой . По умолчаниюнулевой .
FontSettings { get; set; }Позволяет указать настройки шрифта документа.
IgnoreOleData { get; set; }Указывает, следует ли игнорировать данные OLE.
LanguagePreferences { get; }Получает языковые настройки, которые будут использоваться при загрузке документа.
LoadFormat { get; set; }Указывает формат документа для загрузки. Значение по умолчанию:Auto .
MswVersion { get; set; }Позволяет указать, что процесс загрузки документа должен соответствовать определенной версии MS Word. Значение по умолчанию:Word2019
Password { get; set; }Возвращает или задает пароль для открытия зашифрованного документа. Может бытьнулевой или пустая строка. По умолчаниюнулевой .
PreserveIncludePictureField { get; set; }Возвращает или задает, следует ли сохранять поле INCLUDEPICTURE при чтении форматов Microsoft Word. Значение по умолчанию:ЛОЖЬ .
ProgressCallback { get; set; }Вызывается во время загрузки документа и принимает данные о ходе загрузки.
ResourceLoadingCallback { get; set; }Позволяет контролировать загрузку внешних ресурсов (изображений, таблиц стилей) при импорте документа из HTML, MHTML.
TempFolder { get; set; }Позволяет использовать временные файлы при чтении документа. По умолчанию это свойствонулевой и временные файлы не используются.
UpdateDirtyFields { get; set; }Указывает, следует ли обновлять поля с помощьюгрязный атрибут.
UseSystemLcid { get; set; }Возвращает или задает, следует ли использовать значение LCID, полученное из реестра Windows, для определения полей страницы по умолчанию.
WarningCallback { get; set; }Вызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.

Методы

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

Примеры

Показывает, как загрузить зашифрованный документ Microsoft Word.

Document doc;

// Aspose.Words выдает исключение, если мы пытаемся открыть зашифрованный документ без его пароля.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// При загрузке такого документа пароль передается конструктору документа с помощью объекта LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Существует два способа загрузки зашифрованного документа с помощью объекта LoadOptions.
// 1 - Загрузить документ из локальной файловой системы по имени файла:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Загрузить документ из потока:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

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