Vytvořte přizpůsobené dokumenty Word pomocí C# .NET | Aspose.Words Mail Merge Plugin

Automatizace generování dokumentů je klíčová pro firmy, které chtějí vytvářet dynamické zprávy, faktury a dopisy. S Aspose.Words Mail Merge for .NET můžete efektivně vyplňovat Word šablony 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ů, zaměřující se na dynamické vytváření Word dokumentů pomocí C# .NET.

Obsah

• Přehled Mail Merge pro .NET
• Generování dokumentů z různých datových zdrojů
  • Použití C# objektů
  • Použití XML
  • Použití JSON
  • Použití CSV
• Nejlepší postupy pro Mail Merge
• Často kladené otázky

Přehled Mail Merge pro .NET

Plugin Aspose.Words Mail Merge for .NET umožňuje vývojářům vytvářet personalizované dokumenty z předdefinovaných šablon obsahujících sloučená pole. Tato integrace je navržena pro bezproblémové použití v prostředí .NET a nabízí možnosti:

• Dynamicky vyplňovat šablony daty, podporující generování Word dokumentů pro .NET framework.
• Efektivně provádět hromadné generování dokumentů, využívající .NET mail merge řešení pro Word dokumenty.
• Zajišťovat konzistentní formátování napříč výstupy, zlepšující nejlepší postupy šablon Word dokumentů v C#.

Klíčové vlastnosti:

1. Podpora více zdrojů: Využijte data z objektů, databází, XML, JSON a CSV pro vytváření přizpůsobených Word dokumentů pomocí C#.
2. Vysoký výkon: Efektivně zpracovávejte velké datové sady a hromadné operace pro dynamické generování Word dokumentů s .NET Core.
3. Přizpůsobitelné šablony: Vytvářejte šablony s místy pro vložení dat, využívající možnosti .NET Word mail merge automatizace.

Nastavení

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

PM> Install-Package Aspose.Words

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

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

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

V tomto příkladu je sender instance třídy, kterou použijeme k vyplnění šablony pomocí přístupu C# generování Word dokumentu z databáze.

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

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

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

Výstup

Generování Word dokumentu z XML datového zdroje v C#

Chcete-li vygenerovat Word dokument z XML datového zdroje, použijeme složitější Word šablonu 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)]>>

XML datový zdroj použitý v tomto příkladu je uveden níže.

Chcete-li vytvořit Word dokument z XML datového zdroje, postupujte podle těchto kroků:

1. Vytvořte instanci třídy Document a inicializujte ji cestou k Word šabloně.
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 vyplnění Word šablony.
5. Uložte vygenerovaný Word dokument pomocí metody Document.Save().

Zde je ukázka kódu, která demonstruje, jak vygenerovat Word dokument z XML datového zdroje v C#.

Výstup

Generování Word dokumentu z JSON datového zdroje v C#

Nyní se podívejme, jak generovat Word dokument pomocí JSON datového zdroje. V tomto příkladu vytvoříme seznam klientů rozdělených podle jejich manažerů. Word šablona bude vypadat takto:

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

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

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

Výstup

Generování Word dokumentu z CSV datového zdroje v C#

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

<<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 vyplněna pomocí následujících CSV dat:

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

Výstup

Vyzkoušejte Aspose.Words pro .NET zdarma

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

Závěr

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