Wie man ausfüllbare Formularvorlagen in C# mit IronWord erstellt

Was die Funktion macht

Die Seriendruck-Engine verarbeitet beide Arten von Seriendruckfeldern, die Word erzeugt:

• Einfache Felder im "Feldname"-Format, die man erhält, wenn man <> direkt in die Vorlage tippt
• Komplexe Felder, die mehrteilige XML-Struktur, die Word durch Einfügen → Schnellbausteine → Feld erzeugt

Vorlagen können Einzelwert-Platzhalter enthalten, die einmal pro Dokument ersetzt werden, und wiederholende Bereiche, begrenzt durch "Tabellenanfang:Name" und "Tabellenende:Name"-Markierungen, die sich zu einer Zeile pro Datensatz erweitern.

Das zweite Element verleiht der Funktion ihren Mehrwert. Wiederholungsbereiche sind die Methode, wie eine einzelne Template-Zeile in einer Rechnung sich zu einer 50-Zeilen-Artikelpositionstabelle erweitert oder wie ein Kontaktslot in einem Etikettenblatt aus einer Datenbank zu einem vollständigen Avery-Raster wird.

Personalisierte Anschreiben aus einem CRM

Die meisten Teams nutzen den Seriendruck zuerst durch Verkaufsoperationen. Das CRM hält Kundendaten; Marketing oder Verkaufsoperationen müssen personalisierte Anschreiben, Willkommenspakete oder Erneuerungsmitteilungen senden. Das Muster ist einfach: Eine Vorlage, eine Zeile pro Kunde, ein personalisiertes Dokument entsteht.

// Template: "Dear «FirstName», thank you for your order of «Amount»..."
DataTable customers = LoadFromSalesforce();   // FirstName, LastName, Amount, ...

foreach (DataRow row in customers.Rows)
{
    var doc = new WordDocument("cover-letter-template.docx");
    doc.MailMerge.Execute(row);
    doc.SaveAs($"letters/{row["LastName"]}.docx");
}

// Template: "Dear «FirstName», thank you for your order of «Amount»..."
DataTable customers = LoadFromSalesforce();   // FirstName, LastName, Amount, ...

foreach (DataRow row in customers.Rows)
{
    var doc = new WordDocument("cover-letter-template.docx");
    doc.MailMerge.Execute(row);
    doc.SaveAs($"letters/{row["LastName"]}.docx");
}

Imports System.Data

' Template: "Dear «FirstName», thank you for your order of «Amount»..."
Dim customers As DataTable = LoadFromSalesforce() ' FirstName, LastName, Amount, ...

For Each row As DataRow In customers.Rows
    Dim doc As New WordDocument("cover-letter-template.docx")
    doc.MailMerge.Execute(row)
    doc.SaveAs($"letters/{row("LastName")}.docx")
Next

Die Datenquelle ist ein DataTable, was bedeutet, dass alles, was in eine DataTable geladen werden kann (Salesforce, HubSpot, SQL Server, eine CSV, eine API-Antwort), zur Seriendruckquelle wird, ohne dass zusätzlicher Adapter-Code erforderlich ist.

Rechnungen mit wiederkehrenden Positionen

Das Rechnungswesen ist, wo die Fähigkeit zur Wiederholungsbereich ihre Stärken zeigt. Eine Rechnungsvorlage hat einen Kopfbereich (Kundenname, Bestell-ID, Daten), eine Zeile in einer Artikelpositionstabelle und einen Fußbereich (Summen). Wenn der Seriendruck abläuft, erweitert sich die Ein-Template-Zeile zu einer Zeile pro Produkt, unabhängig davon, ob die Bestellung eine Artikelposition oder fünfzig umfasst.

// Template:
//   Bill To: «CustomerName»  Order: «OrderId»
//   ┌──────────┬─────┬──────────┐
//   │ «TableStart:Items»«Product» │ «Qty» │ «LineTotal» «TableEnd:Items» │
//   └──────────┴─────┴──────────┘
//   Total: «Total»

var doc = new WordDocument("invoice-template.docx");

doc.MailMerge.ExecuteWithRegions(orderLineItems);  // one row per product
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CustomerName", "Acme Industries" },
    { "OrderId",      "10444" },
    { "Total",        "$1,117.71" },
});

doc.SaveAs("invoice-10444.docx");

// Template:
//   Bill To: «CustomerName»  Order: «OrderId»
//   ┌──────────┬─────┬──────────┐
//   │ «TableStart:Items»«Product» │ «Qty» │ «LineTotal» «TableEnd:Items» │
//   └──────────┴─────┴──────────┘
//   Total: «Total»

var doc = new WordDocument("invoice-template.docx");

doc.MailMerge.ExecuteWithRegions(orderLineItems);  // one row per product
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CustomerName", "Acme Industries" },
    { "OrderId",      "10444" },
    { "Total",        "$1,117.71" },
});

doc.SaveAs("invoice-10444.docx");

Imports System.Collections.Generic

' Template:
'   Bill To: «CustomerName»  Order: «OrderId»
'   ┌──────────┬─────┬──────────┐
'   │ «TableStart:Items»«Product» │ «Qty» │ «LineTotal» «TableEnd:Items» │
'   └──────────┴─────┴──────────┘
'   Total: «Total»

Dim doc As New WordDocument("invoice-template.docx")

doc.MailMerge.ExecuteWithRegions(orderLineItems)  ' one row per product
doc.MailMerge.Execute(New Dictionary(Of String, String) From {
    {"CustomerName", "Acme Industries"},
    {"OrderId", "10444"},
    {"Total", "$1,117.71"}
})

doc.SaveAs("invoice-10444.docx")

Das gleiche Muster funktioniert für Angebote, Bestellungen, Kontoauszüge und jedes Dokument, bei dem eine variable Anzahl von Elementen in eine festgeformte Seite integriert ist.

Avery Etikettenblätter und Umschläge

Versand- und Betriebsteams erstellen Etiketten und Umschläge aus Kontaktlisten, und die Layouts (Avery 5160, 5161, 5163 und deren internationale Äquivalente) sind standardisierte Vorlagen, die es seit Jahrzehnten gibt. IronWord füllt sie direkt aus: Jede Zelle im Etikettengraster nimmt den entsprechenden Kontakt aus einem einzigen API-Aufruf auf.

// Template: a 3×10 Avery 5160 grid, each cell has «CONTACT_FULLNAME» / «CONTACT_ADDRESS»
var doc = new WordDocument("avery-5160.docx");

doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CONTACT_FULLNAME", "Jane Doe" },
    { "CONTACT_ADDRESS",  "100 Main Street, Boston, MA 02108" },
});

doc.SaveAs("labels-jane.docx");

// Template: a 3×10 Avery 5160 grid, each cell has «CONTACT_FULLNAME» / «CONTACT_ADDRESS»
var doc = new WordDocument("avery-5160.docx");

doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CONTACT_FULLNAME", "Jane Doe" },
    { "CONTACT_ADDRESS",  "100 Main Street, Boston, MA 02108" },
});

doc.SaveAs("labels-jane.docx");

Imports System.Collections.Generic

' Template: a 3×10 Avery 5160 grid, each cell has «CONTACT_FULLNAME» / «CONTACT_ADDRESS»
Dim doc As New WordDocument("avery-5160.docx")

doc.MailMerge.Execute(New Dictionary(Of String, String) From {
    {"CONTACT_FULLNAME", "Jane Doe"},
    {"CONTACT_ADDRESS", "100 Main Street, Boston, MA 02108"}
})

doc.SaveAs("labels-jane.docx")

Für Kontaktlisten mit variabler Länge gilt das ExecuteWithRegions-Muster aus dem Rechnung-Beispiel: Definieren Sie eine Zelle als wiederkehrende Einheit, und der Rest des Blattes füllt sich automatisch.

Multi-Region-Berichte

Die leistungsstärkste Anwendung sind Multi-Region-Berichte. Ein Quartalsbericht könnte "Top Kunden" und "Top Produkte" Abschnitte enthalten, die jeweils von einer eigenen Tabelle angetrieben werden. Mit einem Dataset, das mehrere Tabellen enthält, dehnt der Seriendruck beide Regionen in einem einzigen Aufruf aus.

// Template:
//   Top Customers
//   «TableStart:Customers» • «Name» | «City» | «Revenue» «TableEnd:Customers»
//   Top Products
//   «TableStart:Products»  «ProductName»: «Revenue»     «TableEnd:Products»

var ds = new DataSet();
ds.Tables.Add(topCustomers);   // TableName = "Customers"
ds.Tables.Add(topProducts);    // TableName = "Products"

var doc = new WordDocument("quarterly-report.docx");
doc.MailMerge.ExecuteWithRegions(ds);          // expands both regions
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CompanyName", "Iron Software" },
    { "ReportDate",  "Q2 2026" },
});
doc.SaveAs("Q2-2026-report.docx");

// Template:
//   Top Customers
//   «TableStart:Customers» • «Name» | «City» | «Revenue» «TableEnd:Customers»
//   Top Products
//   «TableStart:Products»  «ProductName»: «Revenue»     «TableEnd:Products»

var ds = new DataSet();
ds.Tables.Add(topCustomers);   // TableName = "Customers"
ds.Tables.Add(topProducts);    // TableName = "Products"

var doc = new WordDocument("quarterly-report.docx");
doc.MailMerge.ExecuteWithRegions(ds);          // expands both regions
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "CompanyName", "Iron Software" },
    { "ReportDate",  "Q2 2026" },
});
doc.SaveAs("Q2-2026-report.docx");

Imports System.Data
Imports System.Collections.Generic

' Template:
'   Top Customers
'   «TableStart:Customers» • «Name» | «City» | «Revenue» «TableEnd:Customers»
'   Top Products
'   «TableStart:Products»  «ProductName»: «Revenue»     «TableEnd:Products»

Dim ds As New DataSet()
ds.Tables.Add(topCustomers)   ' TableName = "Customers"
ds.Tables.Add(topProducts)    ' TableName = "Products"

Dim doc As New WordDocument("quarterly-report.docx")
doc.MailMerge.ExecuteWithRegions(ds)          ' expands both regions
doc.MailMerge.Execute(New Dictionary(Of String, String) From {
    {"CompanyName", "Iron Software"},
    {"ReportDate", "Q2 2026"}
})
doc.SaveAs("Q2-2026-report.docx")

Jede DataTable im DataSet entspricht ihrer entsprechenden "TabelleAnfang:..." Region nach Namen, und die Skalarfelder füllen die Kopfbereichswerte im gleichen Durchgang.

Für Teams mit solchen Dokument-Workflows, die auf eine saubere .NET-Implementierung warten, bündelt die Iron Suite IronWord zusammen mit IronPDF, IronOCR, IronXL und IronBarcode in einer einzigen Lizenz.

Starten Sie eine kostenlose Testversion, keine Kreditkarte erforderlich.

Warum das funktioniert

Einige Dinge unterscheiden diesen Ansatz von den Alternativen:

Native Word-Syntax. Vorlagen werden in Microsoft Word entworfen, unter Verwendung der Seriendruckfeld-Tools, die Word bereits bereitstellt. Speichern als .docx, übergeben Sie die Datei an IronWord, und der Seriendruck läuft. Keine proprietäre Vorlagensprache, keine Übersetzungsschicht, keine separate Lernkurve für das Team, das die Dokumente entwirft.

Sowohl einfache als auch komplexe Feldformate. Word erzeugt zwei verschiedene Feldstrukturen, je nachdem, wie das Feld eingefügt wurde. IronWord verarbeitet beide, was bedeutet, dass bestehende Vorlagen, die von verschiedenen Teammitgliedern auf unterschiedliche Weise entworfen wurden, alle ohne Änderung funktionieren.

Keine externen Abhängigkeiten. Die Bibliothek läuft vollständig auf .NET. Keine Word-Installation, kein COM, keine Office-Lizenz, keine Interop-Instabilität. Der gleiche Code, der auf einer Windows-Entwickler-Maschine läuft, läuft identisch in einem Linux-Container, in einer Azure-Funktion oder in einem serverlosen Build-Agent.

Zusammenfassung

Seriendruck war eine lange bestehende Lücke im .NET-Dokumenten-Tooling-Bereich, und die Umgehungsmöglichkeiten sind nicht gut gealtert. IronWord's nativer Seriendruck schließt diese Lücke mit einem Modell, das Words eigene Seriendruckfeld-Syntax spiegelt, unterstützt sowohl einfache Werte als auch wiederholende Bereiche und läuft ohne das Bereitstellungsgepäck, das historisch mit Dokumentenautomatisierung in .NET einherging.

Für Teams, die Rechnungen, Etiketten, Briefe, Verträge und Berichte in großem Maßstab generieren, ist dies der sauberste Weg von einer einzigen Vorlage zu Tausenden personalisierten Dokumenten.