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

如果这个值不空,则由 Aspose.Words 创建的所有 CSS 类都会从所指定的预定开始,例如,如果您将自定义 CSS 添加到创建的文档中,并希望防止类名冲突。

如果值不或空,则必须是有效的CSS识别器。

Exceptions

ArgumentException

值不是空的,也不是有效的CSS识别器。

CssSavingCallback

允许控制文件保存到 HTML、MHTML 或 EPUB 时如何保存 CSS 风格。

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 for 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.Removing.Practic.HeadingParagraph 和此属性设置为 1 到 9 的值时,文档将分为使用格式化的段落 , 等风格到指定的标题水平。

默认情况下,只有和段落会导致文件分裂. 将此属性设置为零将导致该文件在标题段中根本不分散。

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

Encoding

指定在 HTML、MHTML 或 EPUB 出口时使用的编码,默认值为“新 UTF8Encoding(假)”(UTF-8 无 BOM)。

public Encoding Encoding { get; set; }

财产价值

Encoding

ExportCidUrlsForMhtmlResources

指定是否使用CID(内容ID)URL用于MHTML文档中包含的参考资源(图像、字体、CSS)。

public bool ExportCidUrlsForMhtmlResources { get; set; }

财产价值

bool

Remarks

此选项仅适用于在 MHTML 中存储的文件。

默认情况下,MHTML文件中的资源以文件名(例如“image.png”),与MIME部分的“内容位置”标题相匹配。

此选项允许一个替代方法,其中参考资源文件以CID(内容ID)URL(例如“cid:image.png”)写作,并与“内容ID”标题相匹配。

在理论上,两种参考方法之间不应该有区别,其中一个应该在任何浏览器或邮件代理工作,但在实践中,一些代理人无法通过文件名获取资源,如果您的浏览器或邮件代理人拒绝在MTHML文档中包含的资源(不显示图像或不加载CSS风格),请尝试用CID URL导出文件。

ExportDocumentProperties

指定是否将内置和自定义文档属性出口到 HTML、MHTML 或 EPUB。

public bool ExportDocumentProperties { get; set; }

财产价值

bool

ExportDropDownFormFieldAsText

控制下载表格字段如何存储到 HTML 或 MHTML.默认值是“虚假”。

public bool ExportDropDownFormFieldAsText { get; set; }

财产价值

bool

Remarks

当设置为 , 将下载表格作为正常文本输出字段. 当 , 将下载表格作为 HTML 中的 SELECT 元素输出字段。

在出口到 EPUB 时,文本下载表格字段总是保存为文字,因为这个格式的要求。

ExportFontResources

指定字体资源是否应该出口到HTML、MHTML或EPUB。

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 规则引用每个字母,字体将作为单独的文件输出。

如果 Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 设置为 , 字体不会存储到单独的文件。

在出口字体资源时,应考虑字母许可问题. 希望通过可下载的字符机制使用特定字典的作者必须始终仔细确认他们所意图的使用在字面许证范围内。许多商业字幕目前不允许网上任何形式下載他们的字节。

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

指定字体资源是否应该在 Base64 编码中嵌入到 HTML。

public bool ExportFontsAsBase64 { get; set; }

财产价值

bool

Remarks

默认情况下,字体被写成单独的文件,如果此选项设置为 ,字体将被嵌入到文档的CSS在Base64编码。

ExportHeadersFootersMode

指定头和脚是如何输出到HTML,MHTML或EPUB。默认值是 Aspose.Words.Saving.ExportHeadersFootersMode.PerSection for HTML/MHTML和 Aspose.Words.Saving.ExportHeadersFootersMode.None for EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

财产价值

ExportHeadersFootersMode

Remarks

很难有意义地输出标题和脚印到HTML,因为HTML没有页面。

当本属性是Aspose.Words.Saving.ExportHeadersFootersMode.PerSection,Aspose.Words在每个部分的开始和结束时只出口主要头和脚。

当它是 Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectionFooter 只有第一首头和最后一首首脚(包括链接到以前)被出口。

您可以通过将此属性设置到 Aspose.Words.Saving.ExportHeadersFootersMode.None,完全禁用头条和脚条的出口。

ExportImagesAsBase64

指定图像是否存储在 Base64 格式到输出 HTML、MHTML 或 EPUB。

public bool ExportImagesAsBase64 { get; set; }

财产价值

bool

Remarks

当此属性设置为图像时,数据直接出口到元素中,并且不创建单独的文件。

ExportLanguageInformation

指定语言信息是否出口到HTML、MHTML或EPUB。

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.Images 文件和每个连接图片的 URL 取决于文件文件的文件格式, www.wl26。

ExportPageMargins

指定是否页面边缘出口到HTML、MHTML或EPUB。

public bool ExportPageMargins { get; set; }

财产价值

bool

Remarks

Aspose.Words 不会默认显示页面边缘区域。如果任何元素完全或部分被文档边缘粘贴,则可扩展显示的区域。这个选项。

ExportPageSetup

指定是否页面设置出口到 HTML、MHTML 或 EPUB。

public bool ExportPageSetup { get; set; }

财产价值

bool

Remarks

每个 Aspose.Words.Section 在 Aspose.Words 文档模型提供页面设置信息通过 Aspose.Words.PageSetup 类. 当您出口文档到 HTML 格式,您可能需要保持此信息的进一步使用。

在大多数情况下,HTML旨在在浏览器中无法进行页面化,因此此功能默认不起作用。

ExportRelativeFontSize

指定字体大小是否应该是相对单位的输出,当保存到HTML、MHTML或EPUB。

public bool ExportRelativeFontSize { get; set; }

财产价值

bool

Remarks

在许多现有文档(HTML,DPF EPUB)的字体尺寸是指定的相对单位. 这允许应用程序在查看/处理文件时调整文本大小. 例如,Microsoft Internet Explorer 有“视图>文献大小的”子菜单,Adobe Digital Editions 有两个按钮:增加/减少文本来大。如果你期望这个功能工作,那么设置 Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize属性到。

Aspose Words 文档模型仅包含和运行绝对字体大小单位. 相对单位需要额外的逻辑从某些初始(标准)尺寸重新计算。

当此选项被启用时,文档元素除了文本将仍然具有绝对的尺寸. 此外,一些与文字相关的属性可能会完全表达。特别是,与“准确”规则规定的线路间隔可能会产生不需要的结果,当规模文献. 所以源文件应该是正确设计和测试在出口时与 Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize设置到。

ExportRoundtripInformation

指定在保存到 HTML、MHTML 或 EPUB 时是否要写下旋转信息。默认值为 HTML 的“真实”和为 MHTML 和 EPUB 的“虚假”。

public bool ExportRoundtripInformation { get; set; }

财产价值

bool

Remarks

节省旋转信息允许恢复文档属性,如标签停止,评论,标题和脚在 HTML 文档重新加载到一个 Aspose.Words.Document 对象。

当 , 路径信息被出口为相应的 HTML 元素的 -aw-* CSS 属性。

当 ,不会导致任何环游信息输出到生产的文件。

ExportShapesAsSvg

在保存到 HTML、MHTML、EPUB 或 AZW3 时,检查 Aspose.Words.Drawing.Shape 节点是否转换为 SVG 图像。

public bool ExportShapesAsSvg { get; set; }

财产价值

bool

Remarks

如果此选项设置为 Aspose.Words.Drawing.Shape 节点将作为

ExportTextInputFormFieldAsText

控制文本输入表格字段如何存储到 HTML 或 MHTML.默认值是“虚假”。

publicboolExportTextInputFormFieldAsText{get;set;}