Vorlage in HTML konvertieren – C# Beispiele

Aspose.HTML for .NET bietet eine Reihe von ConvertTemplate() Methoden, die zur Umwandlung einer HTML-Vorlage in ein HTML-Dokument verwendet werden. Die Methoden nehmen mehrere Parameter entgegen, wie den Pfad zur Vorlagendatei, die Datenquelle und die Ladeoptionen, und geben ein HTML-Dokument zurück. Das HTML-Template ist ein Stück HTML-Code, das Platzhalter für dynamische Daten enthält. Diese Platzhalter werden als Ausdrücke bezeichnet und sind in doppelte geschweifte Klammern eingeschlossen, etwa so: {{expression}}. Die Datenquelle liefert die tatsächlichen Werte für diese Ausdrücke. Die Methode ConvertTemplate() ersetzt die Ausdrücke in der Vorlage durch Werte aus der Datenquelle und erzeugt so ein vollständiges HTML-Dokument. Diese Methode kann mit verschiedenen Datenquellentypen verwendet werden, z. B. XML und JSON.

Dieser Artikel beschreibt die Konvertierung von Vorlagen in HTML in C#-Beispielen mit der Aspose.HTML for .NET-Bibliothek.

Vorlage mit einer einzigen Codezeile in HTML umwandeln

Sobald Sie eine HTML-Vorlage vorbereitet haben, können Sie die Vorlage in Ihrer C#-Anwendung buchstäblich mit einer einzigen Codezeile in HTML umwandeln! Dazu müssen Sie die erforderlichen Parameter an die Methode ConvertTemplate(sourcePath, data, options, outputPath) übergeben.

// 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")
);

Vorlage in HTML umwandeln

Verwenden wir die Methode ConvertTemplate(HTMLDocument, TemplateData, TemplateLoadOptions, string), um eine HTML-Vorlage in ein echtes HTML-Dokument umzuwandeln. Die Methode benötigt vier Parameter:

1. das Objekt HTMLDocument wird als Quelle für die Vorlage verwendet.
2. das Objekt TemplateData enthält die Daten, die zum Ausfüllen der Vorlage verwendet werden.
3. das Objekt TemplateLoadOptions bietet Optionen für das Laden der Vorlage.
4. Ein string-Parameter wird verwendet, um den vollständigen HTML-Dateipfad als Ausgabekonvertierungsergebnis anzugeben.

Die Methode verwendet die Informationen aus diesen Parametern, um ein HTML-Dokument zu erzeugen.

// 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();

Der Code erstellt eine Instanz der Klasse HTMLDocument und verwendet die Methode Converter.ConvertTemplate(), um eine Vorlagendatei (template.html) unter Verwendung einer Datenquellendatei (templateData.xml) in ein HTML-Dokument zu konvertieren. Die Methode hat vier Parameter: das HTMLDocument-Objekt, das TemplateData-Objekt, das mit der Datenquelldatei erstellt wurde, das TemplateLoadOptions-Objekt und den Dateipfad für das resultierende HTML-Dokument. Das resultierende HTML-Dokument wird unter dem angegebenen Dateipfad (result.html) gespeichert. Nach der Konvertierung wird das document-Objekt entsorgt.

Vorlage on-the-fly in HTML konvertieren

Wenn Sie in Ihrem Fall Daten angeben und eine Vorlage im Handumdrehen erstellen möchten, müssen Sie einige Schritte beachten:

1. Bereiten Sie eine HTML-Vorlage vor und speichern Sie sie in einer Datei. Die Methode ConvertTemplate() nimmt den Pfad der Vorlagendatei als Parameter (sourcePath).
2. Bereiten Sie eine JSON- und XML-Datenquelle vor und speichern Sie sie in einer Datei. Der Konstruktor TemplateData() übernimmt den Pfad zu dieser Datendatei und erstellt ein Datenobjekt (data) für die Methode ConvertTemplate().
3. Initialisierung einer Instanz der Klasse TemplateLoadOptions, um festzustellen, ob die Namen der Vorlagen und Datenelemente übereinstimmen, unabhängig von der Groß- und Kleinschreibung (options).
4. Rufen Sie die Methode ConvertTemplate() auf und übergeben Sie ihr sourcePath, data, options und outputPath. OutputPath ist ein Pfad zum Speichern der mit Daten gefüllten Vorlagendatei.

// 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 bietet kostenlose Online- Konverter für die Konvertierung von HTML-, XHTML-, MHTML-, EPUB-, XML- und Markdown-Dateien in eine Vielzahl von gängigen Formaten. Sie können ganz einfach HTML in PDF, HTML in JPG, SVG in PDF, MHTML in PDF oder MD in HTML konvertieren. Wählen Sie einfach eine Datei aus, wählen Sie das zu konvertierende Format und fertig. Das geht schnell und ist kostenlos!

Sie können die vollständigen Beispiele und Datendateien von GitHub herunterladen.