Класс Aspose::Words::Loading::LoadOptions

LoadOptions class

Позволяет указать дополнительные параметры (например, пароль или базовый URI) при загрузке документа в объект Document. Чтобы узнать больше, посетите статью документации Specify Load Options.

class LoadOptions : public System::Object

Методы

МетодОписание
Equals(System::SharedPtr<System::Object>) overrideОпределяет, равен ли указанный объект по значению текущему объекту.
get_BaseUri() constПолучает или задает строку, которая будет использоваться для преобразования относительных URI, найденных в документе, в абсолютные URI при необходимости. Может быть null или пустой строкой. По умолчанию null.
get_ConvertMetafilesToPng() constПолучает или задает, следует ли конвертировать метафайлы (Wmf или Emf) в формат изображения Png.
get_ConvertShapeToOfficeMath() constПолучает или задает, следует ли конвертировать фигуры с EquationXML в объекты Office Math.
get_Encoding() constПолучает или задает кодировку, которая будет использоваться для загрузки HTML, TXT или CHM‑документа, если кодировка не указана внутри документа. Может быть null. По умолчанию null.
get_FontSettings() constПозволяет задавать параметры шрифтов документа.
get_IgnoreOleData() constУказывает, следует ли игнорировать данные OLE.
get_LanguagePreferences() constПолучает предпочтения языка, которые будут использоваться при загрузке документа.
get_LoadFormat() constУказывает формат загружаемого документа. По умолчанию — Auto.
get_MswVersion() constПозволяет указать, что процесс загрузки документа должен соответствовать определённой версии MS Word. Значение по умолчанию — Word2019
get_Password() constПолучает или задает пароль для открытия зашифрованного документа. Может быть null или пустой строкой. По умолчанию — null.
get_PreserveIncludePictureField() constПолучает или задает, сохранять ли поле INCLUDEPICTURE при чтении форматов Microsoft Word. Значение по умолчанию — false.
get_ProgressCallback() constВызывается во время загрузки документа и принимает данные о прогрессе загрузки.
get_RecoveryMode() constОпределяет, как следует обрабатывать документ при возникновении ошибок во время загрузки. Используйте это свойство, чтобы указать, должна ли система пытаться восстановить документ или следовать другому определённому поведению. Значение по умолчанию — TryRecover.
get_ResourceLoadingCallback() constПозволяет управлять тем, как внешние ресурсы (изображения, таблицы стилей) загружаются при импорте документа из HTML, MHTML.
get_TempFolder() constПозволяет использовать временные файлы при чтении документа. По умолчанию это свойство равно null, и временные файлы не используются.
get_UpdateDirtyFields() constУказывает, следует ли обновлять поля с атрибутом dirty.
get_UseSystemLcid() constПолучает или задает, использовать ли значение LCID, полученное из реестра Windows, для определения полей страницы по умолчанию.
get_WarningCallback() constВызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.
GetType() const override
Is(const System::TypeInfo&) const override
LoadOptions()Инициализирует новый экземпляр этого класса со значениями по умолчанию.
LoadOptions(const System::String&)Сокращение для инициализации нового экземпляра этого класса с указанным паролем для загрузки зашифрованного документа.
LoadOptions(Aspose::Words::LoadFormat, const System::String&, const System::String&)Сокращение для инициализации нового экземпляра этого класса со свойствами, установленными в указанные значения.
set_BaseUri(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_BaseUri.
set_ConvertMetafilesToPng(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_ConvertMetafilesToPng.
set_ConvertShapeToOfficeMath(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_ConvertShapeToOfficeMath.
set_Encoding(const System::SharedPtr<System::Text::Encoding>&)Сеттер для Aspose::Words::Loading::LoadOptions::get_Encoding.
set_FontSettings(const System::SharedPtr<Aspose::Words::Fonts::FontSettings>&)Сеттер для Aspose::Words::Loading::LoadOptions::get_FontSettings.
set_IgnoreOleData(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_IgnoreOleData.
set_LoadFormat(Aspose::Words::LoadFormat)Сеттер для Aspose::Words::Loading::LoadOptions::get_LoadFormat.
set_MswVersion(Aspose::Words::Settings::MsWordVersion)Сеттер для Aspose::Words::Loading::LoadOptions::get_MswVersion.
set_Password(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_Password.
set_PreserveIncludePictureField(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_PreserveIncludePictureField.
set_ProgressCallback(const System::SharedPtr<Aspose::Words::Loading::IDocumentLoadingCallback>&)Вызывается во время загрузки документа и принимает данные о прогрессе загрузки.
set_RecoveryMode(Aspose::Words::Loading::DocumentRecoveryMode)Сеттер для Aspose::Words::Loading::LoadOptions::get_RecoveryMode.
set_ResourceLoadingCallback(const System::SharedPtr<Aspose::Words::Loading::IResourceLoadingCallback>&)Позволяет управлять тем, как внешние ресурсы (изображения, таблицы стилей) загружаются при импорте документа из HTML, MHTML.
set_TempFolder(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_TempFolder.
set_UpdateDirtyFields(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_UpdateDirtyFields.
set_UseSystemLcid(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_UseSystemLcid.
set_WarningCallback(const System::SharedPtr<Aspose::Words::IWarningCallback>&)Вызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.
static Type()

Примеры

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

System::SharedPtr<Aspose::Words::Document> doc;

// Aspose.Words генерирует исключение, если попытаться открыть зашифрованный документ без пароля.
ASSERT_THROW(static_cast<std::function<void()>>([&doc]() -> void
{
    doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Encrypted.docx");
})(), Aspose::Words::IncorrectPasswordException);

// При загрузке такого документа пароль передаётся конструктору документа с помощью объекта LoadOptions.
auto options = System::MakeObject<Aspose::Words::Loading::LoadOptions>(u"docPassword");

// Существует два способа загрузить зашифрованный документ с объектом LoadOptions.
// 1 -  Загрузить документ из локальной файловой системы по имени файла:
doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Encrypted.docx", options);

// 2 -  Загрузить документ из потока:
{
    System::SharedPtr<System::IO::Stream> stream = System::IO::File::OpenRead(get_MyDir() + u"Encrypted.docx");
    doc = System::MakeObject<Aspose::Words::Document>(stream, options);
}

См. также

Aspose::Words::Loading::LanguagePreferences класс Класс Aspose::Words::Loading::MarkdownLoadOptions