Generování Word ze šablony v C#

Automatizace generování dokumentů je zásadní pro firmy, které chtějí vytvářet dynamické zprávy, faktury a dopisy. S Aspose.Words Mail Merge pro .NET můžete efektivně naplnit šablony Word daty z různých zdrojů, včetně objektů, CSV, JSON a XML. Tento průvodce vás provede využitím Mail Merge v C# pro zjednodušené a automatizované pracovní postupy dokumentů, se zaměřením na dynamické vytváření dokumentů Word pomocí C# .NET.

Témata pokrytá:

Přehled sloučení pošty pro .NET

Aspose.Words Mail Merge pro .NET umožňuje vývojářům generovat personalizované dokumenty ze předem definovaných šablon obsahujících sloučovací pole. Tento plugin je navržen pro bezproblémovou integraci v .NET prostředích a nabízí schopnosti k:

  • Dynamicky naplnit šablony daty, podporující generování dokumentů Word pro .NET framework.
  • Efektivně provádět hromadnou generaci dokumentů, využívající .NET řešení sloučení pošty pro velké datové soubory.
  • Zajistit konzistentní formátování napříč výstupy, zlepšující nejlepší praktiky šablon dokumentů Word v C#.

Klíčové vlastnosti:

  1. Podpora více zdrojů: Použijte data z objektů, databází, XML, JSON a CSV k vytvoření přizpůsobených dokumentů Word s C#.
  2. Vysoký výkon: Efektivně zpracovávejte velké datové soubory a hromadné operace pro dynamické generování dokumentů Word s .NET Core.
  3. Přizpůsobitelné šablony: Vytvářejte šablony s místy pro vložení dat, využívající schopnosti automatizace sloučení pošty Word pro .NET.

Nastavení

Chcete-li začít, nainstalujte Aspose.Words pomocí NuGet:

PM> Install-Package Aspose.Words

Generování dokumentu Word ze šablony pomocí objektů C#

Začněme naplněním šablony Word pomocí objektů C#. Vytvoříme dokument Word (DOC/DOCX) s následujícími místy:

<<[sender.Name]>> říká: "<<[sender.Message]>>."

V tomto příkladu je sender instancí třídy, kterou použijeme k naplnění šablony pomocí přístupu C# generovat dokument Word z databáze.

Dále použijeme reporting engine Aspose.Words k vygenerování dokumentu Word ze šablony a instance třídy Sender podle následujících kroků:

  1. Vytvořte instanci třídy Document a inicializujte ji cestou k šabloně Word.
  2. Vytvořte a inicializujte objekt třídy Sender.
  3. Instancujte třídu ReportingEngine.
  4. Naplňte šablonu pomocí ReportingEngine.BuildReport(), která přijímá instanci dokumentu, zdroj dat a název zdroje dat jako parametry.
  5. Uložte vygenerovaný dokument Word pomocí Document.Save().

Zde je ukázka kódu, která demonstruje, jak vygenerovat dokument Word ze šablony v C#.

Výstup

Generování dokumentu Word ze zdroje dat XML v C#

Chcete-li vygenerovat dokument Word ze zdroje dat XML, použijeme složitější šablonu Word s následujícími místy:

<<foreach [in persons]>>Jméno: <<[Name]>>, Věk: <<[Age]>>, Datum narození: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Průměrný věk: <<[persons.Average(p => p.Age)]>>

Zdrojem dat XML použitým v tomto příkladu je uveden níže.

Chcete-li vytvořit dokument Word ze zdroje dat XML, postupujte podle těchto kroků:

  1. Vytvořte instanci třídy Document a inicializujte ji cestou k šabloně Word.
  2. Vytvořte instanci třídy XmlDataSource a inicializujte ji cestou k XML souboru.
  3. Instancujte třídu ReportingEngine.
  4. Použijte metodu ReportingEngine.BuildReport() k naplnění šablony Word.
  5. Uložte vygenerovaný dokument Word pomocí metody Document.Save().

Zde je ukázka kódu, která demonstruje, jak vygenerovat dokument Word ze zdroje dat XML v C#.

Výstup

Generování dokumentu Word ze zdroje dat JSON v C#

Dále prozkoumejme, jak vygenerovat dokument Word pomocí zdroje dat JSON. V tomto příkladu vytvoříme seznam klientů rozdělených podle jejich manažerů. Šablona Word bude vypadat takto:

<<foreach [in managers]>>Manažer: <<[Name]>>
Smlouvy:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

Odpovídající zdroj dat JSON, který použijeme k naplnění šablony, je níže:

Chcete-li vygenerovat dokument Word ze JSON, použijeme třídu JsonDataSource k načtení zdroje dat, a zbývající kroky budou následovat předchozí strukturu. Zde je ukázka kódu, která demonstruje, jak vygenerovat dokument Word ze šablony JSON v C#.

Výstup

Generování dokumentu Word ze zdroje dat CSV v C#

Chcete-li vygenerovat dokument Word ze zdroje CSV, využijeme následující šablonu Word:

<<foreach [in persons]>>Jméno: <<[Column1]>>, Věk: <<[Column2]>>, Datum narození: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Průměrný věk: <<[persons.Average(p => p.Column2)]>>

Šablona bude naplněna pomocí následujících dat CSV:

Nyní se podívejme na kód C#. Kroky zůstávají stejné s jedním klíčovým rozdílem: použijeme třídu CsvDataSource k načtení dat CSV. Následující ukázka kódu ilustruje, jak vygenerovat dokument Word ze zdroje dat CSV.

Výstup

Vyzkoušejte Aspose.Words pro .NET zdarma

Můžete vyzkoušet Aspose.Words pro .NET pomocí bezplatné dočasné licence.

Závěr

V tomto článku jste se naučili, jak generovat dokumenty Word ze šablon pomocí C#. Prozkoumali jste, jak využít různé zdroje dat, jako jsou objekty, XML, JSON a CSV pro dynamické generování dokumentů v .NET. Pro další informace o schopnostech zpracování šablon Word pro .NET se ponořte do dokumentace a neváhejte se obrátit na naše forum.

Viz také