ExportXhtmlTransitional

HtmlSaveOptions.ExportXhtmlTransitional property

指定保存为 HTML 或 MHTML 时是否写入 DOCTYPE 声明。 当真的，在文档中的根元素之前写入 DOCTYPE 声明。 默认值为错误的. 保存到 EPUB 或 HTML5 时（Html5 ) 始终写入 DOCTYPE 声明。

public bool ExportXhtmlTransitional { get; set; }

评论

无论此设置如何，Aspose.Words 始终会编写格式良好的 HTML。

什么时候真的，HTML 输出文档的开头将如下所示：

Aspose.Words 旨在根据 XHTML 1.0 Transitional 规范 输出 XHTML，但输出并不总是根据 DTD 进行验证。 Microsoft Word 文档中的某些结构很难或不可能映射到将根据 XHTML 架构进行验证的文档。 例如，XHTML 不允许嵌套列表（UL 不能嵌套在另一个 UL 元素内）， 但在 Microsoft Word 文档中，多层列表经常出现。

<?xml version="1.0" encoding="utf-8" standalone="no" ?>
<!DOCTYPE html 
      PUBLIC "-//W3C//DTD XHTML 1.0 过渡 //EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">

例子

演示将文档转换为 Xhtml 1.0 过渡标准时如何显示 DOCTYPE 标题。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Hello world!");

HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html)
{
    HtmlVersion = HtmlVersion.Xhtml,
    ExportXhtmlTransitional = showDoctypeDeclaration,
    PrettyFormat = true
};

doc.Save(ArtifactsDir + "HtmlSaveOptions.ExportXhtmlTransitional.html", options);

// 如果我们将“ExportXhtmlTransitional”标志设置为“true”，我们的文档将仅包含 DOCTYPE 声明标题。
string outDocContents = File.ReadAllText(ArtifactsDir + "HtmlSaveOptions.ExportXhtmlTransitional.html");

if (showDoctypeDeclaration)
    Assert.True(outDocContents.Contains(
        "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"no\"?>\r\n" +
        "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 过渡//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\r\n" +
        "<html xmlns=\"http://www.w3.org/1999/xhtml\">"));
else
    Assert.True(outDocContents.Contains("<html>"));

也可以看看

HtmlSaveOptions.ExportTocPageNumbers HtmlSaveOptions.FontResourcesSubsettingSizeThreshold