将模板转换为 HTML – C# 示例

Aspose.HTML for .NET 提供了一组 ConvertTemplate() 方法，用于将 HTML 模板转换为 HTML 文档。这些方法需要几个参数，如模板文件的路径、数据源和加载选项，然后返回一个 HTML 文档。HTML 模板是一段包含动态数据占位符的 HTML 代码。这些占位符被称为表达式，并用双引号括起来，如下所示：{{表达式}}。数据源为这些表达式提供实际值。ConvertTemplate() 方法将模板中的表达式替换为数据源中的值，生成一个完整的 HTML 文档。该方法可用于各种数据源类型，如 XML 和 JSON。

本文介绍如何在 C# 示例中使用 Aspose.HTML for .NET 库将模板转换为 HTML。

只需一行代码即可将模板转换为 HTML

准备好 HTML 模板后，只需一行代码就能在 C# 应用程序中将模板转换为 HTML！为此，您需要向 ConvertTemplate(sourcePath, data, options, outputPath) 方法传递所需的参数。

// Convert Template to HTML using C#

// Convert template to HTML
Converter.ConvertTemplate(
    Path.Combine(DataDir, "template.html"),
    new TemplateData(Path.Combine(DataDir, "data-source.json")),
    new TemplateLoadOptions(),
    Path.Combine(OutputDir, "template-with-single-line.html")
);

将模板转换为 HTML

让我们使用 ConvertTemplate(HTMLDocument, TemplateData, TemplateLoadOptions, string) 方法将 HTML 模板转换为真正的 HTML 文档。该方法需要四个参数：

1. HTMLDocument 对象被用作模板的源代码。
2. TemplateData 对象保存用于填充模板的数据。
3. TemplateLoadOptions 对象提供了加载模板的选项。
4. 使用 string 参数指定完整的 HTML 文件路径作为输出转换结果。

该方法使用这些参数中的信息生成 HTML 文档。

// Populate HTML template with external XML data using C#

// Prepare a path to an HTML source file
string sourcePath = Path.Combine(DataDir, "template.html");

// Prepare a path to an xml template data file
string templateDataPath = Path.Combine(DataDir, "templateData.xml");

// Define TemplateData object instance
TemplateData templateData = new TemplateData(templateDataPath);

// Prepare a path to the result file
string resultPath = Path.Combine(OutputDir, "result.html");

// Define default TemplateLoadOptions object
TemplateLoadOptions options = new TemplateLoadOptions();

// Initialize an HTML document as conversion source
HTMLDocument document = new HTMLDocument(sourcePath, new Configuration());

// Convert template to HTML
Converter.ConvertTemplate(document, templateData, options, resultPath);

// Clear resources
document.Dispose();

这段代码创建了一个 HTMLDocument 类实例，并使用 Converter.ConvertTemplate method() 将模板文件 (template.html) 转换为使用数据源文件 (templateData.xml) 的 HTML 文档。该方法需要四个参数：HTMLDocument 对象、使用数据源文件创建的 TemplateData 对象、TemplateLoadOptions 对象和生成的 HTML 文档的文件路径。生成的 HTML 文档将保存到指定的文件路径 (result.html)。转换完成后，将处置 document 对象。

即时将模板转换为 HTML

如果您的情况涉及指定数据和即时创建模板，您必须遵循几个步骤：

1. 准备 HTML 模板并将其保存到文件中。ConvertTemplate() 方法将模板文件的路径作为参数(sourcePath)。
2. 准备 JSON 和 XML 数据源并将其保存到文件中。TemplateData() 构造函数获取该数据文件的路径，并为 ConvertTemplate() 方法创建一个数据对象(data)。
3. 初始化 TemplateLoadOptions 类的实例，以确定模板名称和数据项名称是否匹配，无论大小写(options)。
4. 调用 ConvertTemplate() 方法并为其传递 sourcePath、data、options 和 outputPath。OutputPath 是数据填充模板文件的保存路径。

// Populate an HTML template with structured JSON data using C#

// Prepare a path to JSON data source file
string jsonPath = Path.Combine(OutputDir, "data-source.json");

// Prepare a JSON data source and save it to the file
string data = @"{
    ""FirstName"": ""John"",
    ""LastName"": ""Doe"",
    ""Address"": {
        ""City"": ""Dallas"",
        ""Street"": ""Austin rd."",
        ""Number"": ""200""
        }
    }";
File.WriteAllText(jsonPath, data);

// Prepare a path to an HTML Template file
string sourcePath = Path.Combine(OutputDir, "template.html");

// Prepare an HTML Template and save it to the file
string template = @"
    <table border=1>
        <tr>
            <th>Person</th>
            <th>Address</th>
        </tr>
        <tr>
            <td>{{FirstName}} {{LastName}}</td>
            <td>{{Address.Street}} {{Address.Number}}, {{Address.City}}</td>
        </tr>
    </table>
    ";
File.WriteAllText(sourcePath, template);

// Prepare a path to the output file (data-filled template file)
string outputPath = Path.Combine(OutputDir, "template-output.html");

// Invoke Converter.ConvertTemplate() method in order to populate "template.html" with the data source from "data-source.json" file
Converter.ConvertTemplate(sourcePath, new TemplateData(jsonPath), new TemplateLoadOptions(), outputPath);

Aspose.HTML 提供免费的在线 转换器，用于将 HTML、XHTML、MHTML、EPUB、XML 和 Markdown 文件转换为各种流行格式。您可以轻松地将 HTML 转换为 PDF、 HTML 转换为 JPG、 SVG 转换为 PDF、 MHTML 转换为 PDF 或 MD 转换为 HTML，只需选择文件，选择要转换的格式，就大功告成了。它速度快，而且完全免费！