Generate Word from template in C#

Die Automatisierung der Dokumentenerstellung ist entscheidend für Unternehmen, die dynamische Berichte, Rechnungen und Briefe erstellen möchten. Mit Aspose.Words Mail Merge für .NET können Sie Word-Vorlagen effizient mit Daten aus verschiedenen Quellen füllen, einschließlich Objekten, CSV, JSON und XML. Dieser Leitfaden zeigt Ihnen, wie Sie Mail Merge in C# nutzen, um optimierte und automatisierte Dokumenten-Workflows zu erstellen, mit einem Fokus auf dynamische Word-Dokumenterstellung mit C# .NET.

Inhaltsverzeichnis

Überblick über Mail Merge für .NET

Das Aspose.Words Mail Merge für .NET-Plugin ermöglicht Entwicklern, personalisierte Dokumente aus vordefinierten Vorlagen mit Merge-Feldern zu erstellen. Diese Integration ist für die nahtlose Verwendung in .NET-Umgebungen konzipiert und bietet Funktionen, um:

  • Vorlagen dynamisch mit Daten zu füllen, die die Word-Dokumenterstellung im .NET-Framework unterstützen.
  • Effizient eine Massen-Dokumentenerstellung durchzuführen, wobei die .NET-Mail-Merge-Lösung für Word-Dokumente genutzt wird.
  • Eine konsistente Formatierung in den Ausgaben sicherzustellen und die Best Practices für Word-Dokumentvorlagen in C# zu verbessern.

Hauptmerkmale:

  1. Multi-Source-Unterstützung: Nutzen Sie Daten aus Objekten, Datenbanken, XML, JSON und CSV, um angepasste Word-Dokumente mit C# zu erstellen.
  2. Hohe Leistung: Effiziente Verarbeitung großer Datensätze und Massenoperationen für dynamische Word-Dokumentenerstellung mit .NET Core.
  3. Anpassbare Vorlagen: Erstellen Sie Vorlagen mit Platzhaltern für die Dateneinfügung, indem Sie die .NET Word Mail Merge-Automatisierungs-Funktionen nutzen.

Einrichtung

Um loszulegen, installieren Sie Aspose.Words über NuGet:

PM> Install-Package Aspose.Words

Generieren eines Word-Dokuments aus einer Vorlage mit C#-Objekten

Lassen Sie uns beginnen, indem wir eine Word-Vorlage mit C#-Objekten füllen. Wir werden ein Word-Dokument (DOC/DOCX) mit den folgenden Platzhaltern erstellen:

<<[sender.Name]>> sagt: "<<[sender.Message]>>."

In diesem Beispiel ist sender eine Instanz einer Klasse, die wir verwenden werden, um die Vorlage mit dem C#-Ansatz zur Generierung von Word-Dokumenten aus einer Datenbank zu füllen.

Als Nächstes werden wir die Reporting-Engine von Aspose.Words verwenden, um das Word-Dokument aus der Vorlage und der Instanz der Sender-Klasse zu generieren, indem wir die folgenden Schritte befolgen:

  1. Erstellen Sie eine Instanz der Document Klasse und initialisieren Sie sie mit dem Pfad zur Word-Vorlage.
  2. Erstellen und initialisieren Sie ein Objekt der Sender-Klasse.
  3. Instanziieren Sie die ReportingEngine Klasse.
  4. Füllen Sie die Vorlage mit ReportingEngine.BuildReport(), die die Instanz des Dokuments, die Datenquelle und den Namen der Datenquelle als Parameter entgegennimmt.
  5. Speichern Sie das generierte Word-Dokument mit Document.Save().

Hier ist das Codebeispiel, das zeigt, wie Sie ein Word-Dokument aus einer Vorlage generieren können in C#.

Ausgabe

Generieren eines Word-Dokuments aus einer XML-Datenquelle in C#

Um ein Word-Dokument aus einer XML-Datenquelle zu generieren, verwenden wir eine komplexere Word-Vorlage mit den folgenden Platzhaltern:

<<foreach [in persons]>>Name: <<[Name]>>, Alter: <<[Age]>>, Geburtsdatum: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Durchschnittsalter: <<[persons.Average(p => p.Age)]>>

Die in diesem Beispiel verwendete XML-Datenquelle ist unten dargestellt.

Um ein Word-Dokument aus einer XML-Datenquelle zu erstellen, befolgen Sie diese Schritte:

  1. Erstellen Sie eine Instanz der Document-Klasse und initialisieren Sie sie mit dem Pfad zur Word-Vorlage.
  2. Erstellen Sie eine Instanz der XmlDataSource Klasse und initialisieren Sie sie mit dem Pfad zur XML-Datei.
  3. Instanziieren Sie die ReportingEngine-Klasse.
  4. Verwenden Sie die Methode ReportingEngine.BuildReport(), um die Word-Vorlage zu füllen.
  5. Speichern Sie das generierte Word-Dokument mit der Methode Document.Save().

Hier ist das Codebeispiel, das zeigt, wie Sie ein Word-Dokument aus einer XML-Datenquelle generieren können in C#.

Ausgabe

Generieren eines Word-Dokuments aus einer JSON-Datenquelle in C#

Als Nächstes erkunden wir, wie man ein Word-Dokument mit einer JSON-Datenquelle generiert. In diesem Beispiel werden wir eine Liste von Kunden erstellen, die nach ihren Managern segmentiert ist. Die Word-Vorlage sieht folgendermaßen aus:

<<foreach [in managers]>>Manager: <<[Name]>>
Verträge:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

Die entsprechende JSON-Datenquelle, die wir verwenden werden, um die Vorlage zu füllen, ist unten dargestellt:

Um das Word-Dokument aus JSON zu generieren, verwenden wir die JsonDataSource Klasse, um die Datenquelle zu laden, und die verbleibenden Schritte folgen der vorherigen Struktur. Hier ist das Codebeispiel, das zeigt, wie Sie ein Word-Dokument aus der JSON-Vorlage generieren können in C#.

Ausgabe

Generieren eines Word-Dokuments aus einer CSV-Datenquelle in C#

Um das Word-Dokument aus einer CSV-Quelle zu generieren, verwenden wir die folgende Word-Vorlage:

<<foreach [in persons]>>Name: <<[Column1]>>, Alter: <<[Column2]>>, Geburtsdatum: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Durchschnittsalter: <<[persons.Average(p => p.Column2)]>>

Die Vorlage wird mit den folgenden CSV-Daten gefüllt:

Jetzt lassen Sie uns den C#-Code überprüfen. Die Schritte bleiben gleich, mit einem wichtigen Unterschied: Wir verwenden die CsvDataSource Klasse, um die CSV-Daten zu laden. Das folgende Codebeispiel zeigt, wie Sie das Word-Dokument aus einer CSV-Datenquelle generieren können.

Ausgabe

Testen Sie Aspose.Words für .NET kostenlos

Sie können Aspose.Words für .NET mit einer kostenlosen temporären Lizenz testen.

Fazit

In diesem Artikel haben Sie gelernt, wie Sie Word-Dokumente aus Vorlagen mit C# generieren. Sie haben erkundet, wie Sie verschiedene Datenquellen wie Objekte, XML, JSON und CSV für dynamische Dokumentenerstellung in .NET nutzen können. Für weitere Einblicke in die Möglichkeiten der .NET Word-Vorlagenverarbeitung tauchen Sie in die Dokumentation ein und zögern Sie nicht, uns über unser Forum zu kontaktieren.