Class HtmlSaveOptions

Названий на: Aspose.Words.Saving Асамблея: Aspose.Words.dll (25.4.0)

Її можна використовувати для визначення додаткових варіантів при збереженні документа вСтворення Aspose.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,Створення Aspose.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 іАпсо.Words.Saving.CssStyleSheetType.External для EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

вартість нерухомості

CssStyleSheetType

Remarks

При експорті до одного з контейнерних форматів (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.Загальна вартість - “новий UTF8Encoding(false)” (UTF-8 без 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”), які відповідають заголовкам “Контент-Локація” частин 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

Слідкує за тим, як в HTML або MHTML зберігаються поля в форматі drop-down.Default value is ‘fake’.

public bool ExportDropDownFormFieldAsText { get; set; }

вартість нерухомості

bool

Remarks

При налаштуванні до , експортується форма drop-down полів як звичайний текст. Коли , експортується форма drop-down полів як елемент 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 в порядку, а фотки будуть виходити як окремі файли. При експорті до IDPF EPUB або MHTML форматів, букви будуть вбудовані в відповідний пакет разом з іншими дочірніми файлами.

Якщо налаштується Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 , шрифти не будуть збережені до окремих файлів.

При експорті ресурсів шрифту слід розглядати проблеми ліцензування шrift. Автори, які хочуть використовувати певні шпигуни за допомогою завантажуваного механізму font, повинні завжди ретельно перевіряти, що їхнє намірне використання знаходиться в межах сфери експлуатації font. Багато комерційних fonts в даний час не дозволяють веб-завантаження своїх font в будь-якій формі. Ліцензійні угоди , які охоплюють деякі font конкретно зауважують , що використання через правила в CSS стилі листів не допускається.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Визначає, чи повинні ресурси шрифтів бути вбудовані в HTML в Base64 кодування.Default є “фальшивим”.

public bool ExportFontsAsBase64 { get; set; }

вартість нерухомості

bool

Remarks

За замовчуванням шрифти написані на окремі файли. якщо ця опція встановлена , шрифти будуть вбудовані в CSS документа в Base64 кодування.

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 кожної з’єднаної картини побудовані залежно від папки документа, W L26.Give.View.Immages.

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 Модель документа Words містить і працює тільки з абсолютними шрифтовими розмірами одиниць. релативні об’єкти потребують додаткової логіки, щоб бути перераховані з деякого початкового (стандартного) розміру. Розмір шриму в стилі документа приймається як стандарт. Наприклад, якщо у нього є 12пт шпигун і деякий текст 18пту, то це буде вихід до HTML.

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

ExportRoundtripInformation

Визначає, чи потрібно писати інформацію обертання при збереженні в HTML, MHTML або EPUB.Загальна вартість є «правдивою» для HTML і «неправдивою» для MHTML і EPUB.

public bool ExportRoundtripInformation { get; set; }

вартість нерухомості

bool

Remarks

Збереження інформації обертання дозволяє відновити документальні властивості, такі як зупинки клавіші, коментарі, заголовки та ноги під час HTML-документів, які завантажуються назад в об’єкт Aspose.Words.Document.

Коли інформація обертання експортується як -aw-* 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;}