Class HtmlSaveOptions

Название пространства: Aspose.Words.Saving Ассоциация: Aspose.Words.dll (25.4.0)

Может использоваться для уточнения дополнительных вариантов при сохранении документа вАпсо.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.EpubВ формате Aspose.Words.SaveFormat.Azw3 или Aspose.Words.SaveFormat.Mobi.

Чтобы узнать больше, посетите Specify Save Options Документационная статья .

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

Наследованные члены

SaveOptions.CreateSaveOptions(SaveFormat) , SaveOptions.CreateSaveOptions(string) , SaveOptions.SaveFormat , SaveOptions.ExportGeneratorName , SaveOptions.TempFolder , SaveOptions.PrettyFormat , SaveOptions.UseAntiAliasing , SaveOptions.UseHighQualityRendering , SaveOptions.DmlRenderingMode , SaveOptions.DmlEffectsRenderingMode , SaveOptions.ImlRenderingMode , SaveOptions.DefaultTemplate , SaveOptions.UpdateFields , SaveOptions.UpdateLastSavedTimeProperty , SaveOptions.UpdateLastPrintedProperty , SaveOptions.UpdateCreatedTimeProperty , SaveOptions.MemoryOptimization , SaveOptions.UpdateAmbiguousTextFont , SaveOptions.Dml3DEffectsRenderingMode , SaveOptions.ProgressCallback , SaveOptions.AllowEmbeddingPostScriptFonts , SaveOptions.CustomTimeZoneInfo , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

HtmlSaveOptions()

Инициализует новую инстанцию этого класса, которая может быть использована для сохранения документав формате Aspose.Words.SaveFormat.Html.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Инициализует новую инстанцию этого класса, которая может быть использована для сохранения документав Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,В формате Aspose.Words.SaveFormat.Azw3 или Aspose.Words.SaveFormat.Mobi.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Это могут быть Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Аппосе.Words.SaveFormat.Azw3 или Aspose.Words.SaveFormat.Mobi.

Properties

AllowNegativeIndent

Определяет, нормализуются ли отрицательные левые и правые вложения параграфов при сохранении в HTML, MHTML или EPUB.

public bool AllowNegativeIndent { get; set; }

Стоимость недвижимости

bool

Remarks

Когда отрицательный индекс не допускается, он экспортируется в качестве нулевой маргины в HTML. Когда отрицательный индекс допускается, параграф может появляться частично за пределами окна браузера.

CssClassNamePrefix

Определяет префикс, который добавляется к всем названиям класса CSS.Стандартная стоимость — это пустая строка, и генерируемые названия класса CSS не имеют общего предпочтения.

public string CssClassNamePrefix { get; set; }

Стоимость недвижимости

string

Remarks

Если эта стоимость не пустая, то все классы CSS, генерируемые компанией Aspose.Words, начнут с указанного предпочтения. Это может быть полезным, например, если вы добавите персонализированный CSS к генерируемым документам и хотите предотвратить конфликты названия класса.

Если значение не является или пусто, то оно должно быть валидным идентификатором CSS.

Exceptions

ArgumentException

Стоимость не пустая и не является валидным идентификатором CSS.

CssSavingCallback

Это позволяет контролировать, как CSS стили хранятся, когда документ хранятся в HTML, MHTML или EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

Стоимость недвижимости

ICssSavingCallback

CssStyleSheetFileName

Определяет путь и название файла Cascading Style Sheet (CSS), написанного, когда документЭкспортируется в HTML.По умолчанию, это пустая строка.

public string CssStyleSheetFileName { get; set; }

Стоимость недвижимости

string

Remarks

Эта свойство действует только при сохранении документа в формате HTML, а внешний стильный лист CSS запрашивается с помощью Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType.

Если эта свойство пусто, файл CSS будет храниться в том же папке и с тем же названием, что и документ HTML, но с расширенностью “css”.

Если в этой собственности указано только путь, но нет названия файла, файл CSS будет сохранен в указанную папку и будет иметь то же название, что и документ HTML, но с расширением “css”.

Если папка, указанная этим свойством, не существует, она будет создана автоматически до сохранения файла CSS.

Другой способ указать папку, в которой хранится внешний CSS-файл, является использование Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder Aspose.Words.Saving.HtmlSaveOptions.ResourceFolderAlias Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType

CssStyleSheetType

Определяет, как стили CSS (Cascading Style Sheet) экспортируются в HTML, MHTML или EPUB.Стандартная стоимость — Aspose.Words.Saving.CssStyleSheetType.Inline для HTML/MHTML иAspose.Words.Saving.CssStyleSheetType.External для EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

Стоимость недвижимости

CssStyleSheetType

Remarks

Сохранение стиля CSS в внешний файл поддерживается только при сохранении в HTML. Когда вы экспортируете в один из контейнерных форматов (EPUB или MHTML) и указываете Aspose.Words.Saving.CssStyleSheetType.External, CSS-файл будет включен в пакет выхода.

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

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Это позволяет контролировать, как части документа хранятся, когда документ хранится в HTML или EPUB.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

Стоимость недвижимости

IDocumentPartSavingCallback

DocumentSplitCriteria

Определяет, как документ должен быть разделен при сохранении в Aspose.Words.SaveFormat.Html,Формат Aspose.Words.SaveFormat.Epub или Aspose.Words.SaveFormat.Azw3.По умолчанию это Aspose.Words.Saving.DocumentSplitCriteria.None для HTML иAspose.Words.Saving.DocumentSplitCriteria.HeadingПараграф для EPUB и AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

Стоимость недвижимости

DocumentSplitCriteria

Remarks

Как правило, вы хотите, чтобы документ был сохранен в HTML как единый файл. Но в некоторых случаях предпочтительнее разделить выход на несколько меньших HTML-страниц. При сохранении в формате HTML эти страницы будут выхода на отдельные файлы или потоки.

Документ не может быть разделен при сохранении в формате MHTML.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitHeadingLevel Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

DocumentSplitHeadingLevel

Определяет максимальный уровень заголовков, на котором можно разделить документ.Предварительная стоимость «2».

public int DocumentSplitHeadingLevel { get; set; }

Стоимость недвижимости

int

Remarks

Когда Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria включает в себя __ WL26.DOCUMENTSPLit.HeadingParagraph и эта свойство устанавливается до значения от 1 до 9, документ будет разделен на параграфы, форматированные с помощью , и т. д. стили до указанного уровня заголовка.

По умолчанию, только и параграфы заставляют документ быть разделенным.Настройка этого имущества до нуля приведет к тому, что документ вовсе не делится на заголовки.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

Encoding

Определяет кодирование, которое нужно использовать при экспорте в HTML, MHTML или EPUB.Default value is ’new UTF8Encoding(false)’ (UTF-8 without BOM).

public Encoding Encoding { get; set; }

Стоимость недвижимости

Encoding

ExportCidUrlsForMhtmlResources

Указывает, следует ли использовать CID (Content-ID) URL-адресы для ссылок ресурсов (изображений, шрифтов, CSS), включенных в MHTML-документы.

public bool ExportCidUrlsForMhtmlResources { get; set; }

Стоимость недвижимости

bool

Remarks

Эта опция затрагивает только документы, которые хранятся в MHTML.

По умолчанию, ресурсы в документах MHTML ссылаются по названию файла (например, “image.png”), которые совпадают с заголовками “Content-Location” части MIME.

Эта опция позволяет использовать альтернативный метод, при котором ссылки на ресурсные файлы записываются как CID (Content-ID) URL (например, «cid:image.png») и совпадают с заголовками «Content-ID».

В теории не должно быть никакой разницы между двумя референтными методами, и ни один из них должен работать хорошо в любом браузере или почтовом агенте. В практике, однако, некоторые агенты не справляются с ресурсами по названию файла. Если ваш браузер или почтовый агент отказывается загружать ресурсы, включенные в документ MTHML (не показывает изображений или не загружает CSS стилей), постарайтесь экспортировать документ с URL-адресами CID.

ExportDocumentProperties

Определяет, следует ли экспортировать встроенные и персонализированные свойства документа в HTML, MHTML или EPUB.Предварительная стоимость является «фальшивой».

public bool ExportDocumentProperties { get; set; }

Стоимость недвижимости

bool

ExportDropDownFormFieldAsText

Контролирует, как поля в форме drop-down хранятся в HTML или MHTML.Default value is ‘fake’.

public bool ExportDropDownFormFieldAsText { get; set; }

Стоимость недвижимости

bool

Remarks

При настройке на , экспортирует шаблоны сжатия в виде обычного текста. когда , экспортирует шаблоны сжатия в виде элемента SELECT в HTML.

При экспорте в EPUB, текстовые шаблоны формы всегда хранятся в качестве текста из-за требований этого формата.

ExportFontResources

Определяет, следует ли экспортировать ресурсы шрифта в HTML, MHTML или EPUB.Default является «фальшивым».

public bool ExportFontResources { get; set; }

Стоимость недвижимости

bool

Remarks

<p>Exporting font resources allows for consistent document rendering independent of the fonts available
         in a given user's environment.</p>

Если Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources устанавливается на , главный HTML-документ будет ссылаться на каждый шрифт через CSS 3 в норме и fonts будут выходить как отдельные файлы.

Если Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 настроен, шрифты не будут сохранены в отдельные файлы.

При экспорте ресурсов шрифта должны рассматриваться вопросы лицензирования шрифов. Авторы, которые хотят использовать конкретные шрыфы через загружаемый шпионский механизм, должны всегда тщательно проверить, что их предназначенное использование находится в пределах лицензии шф. Многие коммерческие штрифы в настоящее время не позволяют веб-загрузить свои шфины в какой-либо форме. Лицензионные соглашения, покрывающие некоторые штиты конкретно отмечают, чтобы использование через правила в стиле CSS листов не допускается.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Определяет, должны ли ресурсы шрифтов быть встроены в HTML в Base64 encoding.Default является “фальсифицированным”.

public bool ExportFontsAsBase64 { get; set; }

Стоимость недвижимости

bool

Remarks

По умолчанию, шрифты записываются в отдельные файлы. если данная опция настроенная, шрифты будут встроены в CSS документа в базовом 64-м кодировании.

ExportHeadersFootersMode

Определяет, как заголовки и ноги являются выходом в HTML, MHTML или EPUB.Стандартная стоимость Aspose.Words.Saving.ExportHeadersFootersMode.PerSection для HTML/MHTMLи Aspose.Words.Saving.ExportHeadersFootersMode.None для EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

Стоимость недвижимости

ExportHeadersFootersMode

Remarks

Трудно существенно выводить заголовки и ноги в HTML, потому что HTML не настраивается.

Когда это имущество является Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, Aspose.Words экспортирует только первичные головки и ноги в начале и конце каждой секции.

Когда это Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectFooter только первый первичный заголовок и последний основный футер (включая ссылки на предыдущий) экспортируются.

Вы можете отключить экспорт голов и ног в полном объеме, размещая эту недвижимость в Aspose.Words.Saving.ExportHeadersFootersMode.None.

ExportImagesAsBase64

Определяет, хранятся ли изображения в формате Base64 до выхода HTML, MHTML или EPUB.Default является «фальшивым».

public bool ExportImagesAsBase64 { get; set; }

Стоимость недвижимости

bool

Remarks

При настройке этого свойства на изображения данные экспортируются непосредственно в элементы, а отдельные файлы не создаются.

ExportLanguageInformation

Определяет, экспортируется ли информация о языке в HTML, MHTML или EPUB.Default является «фальшивой».

public bool ExportLanguageInformation { get; set; }

Стоимость недвижимости

bool

Remarks

Когда эта свойство устанавливается на Aspose.Words выходит HTML атрибут на элементы документа, которые определяют язык.

ExportListLabels

Контролирует, как этикетки списка выходят в HTML, MHTML или EPUB.Стандартная стоимость — Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

Стоимость недвижимости

ExportListLabels

ExportOriginalUrlForLinkedImages

Определяет, следует ли использовать оригинальный URL в качестве URL связанных изображений.Предварительная стоимость является «фальшивой».

public bool ExportOriginalUrlForLinkedImages { get; set; }

Стоимость недвижимости

bool

Remarks

Если значение настроенное на Aspose.Words.Drawing.ImageData.SourceFullName значение используется как URL связанных изображений и связанных изображений не загружаются в папку документа или Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Если значение устанавливается на связанные изображения, то загружаются в папку документа или Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder и URL каждого связанного образа построены в зависимости от папки документа, __ WL26.

ExportPageMargins

Определяет, экспортируются ли маргины страниц в HTML, MHTML или EPUB.Default является «фальшивым».

public bool ExportPageMargins { get; set; }

Стоимость недвижимости

bool

Remarks

Aspose.Words не показывает область страничных маргинов по умолчанию.Если какие-либо элементы полностью или частично склеиваются краем документа, отображаемая площадь может быть расширена сЭтот вариант.

ExportPageSetup

Определяет, экспортируется ли настройка страницы в HTML, MHTML или EPUB.Default является «фальшивой».

public bool ExportPageSetup { get; set; }

Стоимость недвижимости

bool

Remarks

Каждый Aspose.Words.Section в Aspose.Words документальной модели предоставляет информацию о настройке страницы через Aspose.Words.PageSetup класс. Когда вы экспортируете документ в HTML-формат, вам может понадобиться сохранить эту информацию для дальнейшего использования. В частности, настройка страницы может быть важной для передачи в пегированные медиа (печатки) или последующей конверсии в коренные форматы файлов Microsoft Word (DOCX, DOC, RTF, WML).

В большинстве случаев HTML предназначен для просмотра в браузерах, где странизация не выполняется.

ExportRelativeFontSize

Определяет, должны ли размеры шрифта быть выходами в относительных единицах при сохранении в HTML, MHTML или EPUB.Default является «фальшивым».

public bool ExportRelativeFontSize { get; set; }

Стоимость недвижимости

bool

Remarks

В многих существующих документах (HTML, IDPF EPUB) размеры шрифта указаны в относительных единицах. Это позволяет приложениям корректировать размер текста при просмотре/обработке документов. К примеру, Microsoft Internet Explorer имеет подменю «Посмотреть>Величие текста», Adobe Digital Editions имеет два кнопки: Увеличение/Уменьшение размеров текста. Если вы ожидаете, что эта функциональность будет работать, то установите Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize свойство к .

Aspose Модель документа слов содержит и работает только с единицами абсолютного размера шрифта. Относительные единицы нуждаются в дополнительной логике, чтобы быть пересчитаны с некоторых начальных (стандартных) размеров. Шрифт размер стиля документа принимается как стандарт. К примеру, если у него есть 12пт буквы и какой-то текст 18пту, то это будет выход по отношению к HTML.

Когда данная опция включена, элементы документа, кроме текста, все еще будут иметь абсолютные размеры. Также некоторые атрибуты, связанные с текстом, могут быть выражены абсолютно. В частности, линия пространства, указанная “точным” правилом, может производить нежелательные результаты при сканировании текста. Так что источники документов должны быть надлежащим образом разработаны и тестированы при экспорте с Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize .

ExportRoundtripInformation

Определяет, следует ли записывать круглую информацию при сохранении в HTML, MHTML или EPUB.Default value is ’true’ for HTML and ‘false’ for MHTML and EPUB.

public bool ExportRoundtripInformation { get; set; }

Стоимость недвижимости

bool

Remarks

Сохранение информации о маршруте позволяет восстановить свойства документа, такие как остановки клавиш, комментарии, заголовки и ноги, во время загрузки HTML-документов обратно в объект Aspose.Words.Document.

Когда информация оборота экспортируется в качестве CSS свойств соответствующих HTML элементов.

Когда, не вызывает оборотной информации, чтобы быть выходом в произведенные файлы.

ExportShapesAsSvg

Контролирует, конвертируются ли узлы Aspose.Words.Drawing.Shape в изображения SVG при сохранении в HTML, MHTML, EPUB или AZW3.

public bool ExportShapesAsSvg { get; set; }

Стоимость недвижимости

bool

Remarks

Если данная опция установлена на , Aspose.Words.Drawing.Shape узлы экспортируются какэлементов.

ExportTextInputFormFieldAsText

Контролирует, как текстовые входные формы полей хранятся в HTML или MHTML.Предварительная стоимость является «фальсифицированной».

publicboolExportTextInputFormFieldAsText{get;set;}