Generate Word from template in C#

Automatisk dokumentgenerering är avgörande för företag som vill skapa dynamiska rapporter, fakturor och bokstäver. Med Aspose.Words Mail Merge för .NET kan du effektivt populera Word-mallar med data från olika källor, inklusive objekt, CSV, JSON och XML. Denna guide kommer att gå dig genom att använda Mail Merge i C# för snabba och automatiserade dokumentarbetsflöden, med fokus på dynamisk Word-dokumentskapande med C# .NET.

Tabell av innehåll

Översikt över Mail Merge för .NET

Aspose.Words Mail Merge för .NET-plugin gör det möjligt för utvecklare att skapa personliga dokument från fördefinierade mallar som innehåller fusionsfält:

  • Dynamiskt populera mallar med data, som stöder .NET-ramverk Word-dokumentgenerering.
  • Effektivt utför massdokumentgenerering genom att använda .NET mail merge lösning för Word-dokument.
  • Säkerställa konsekvent formatering över utgångar, förbättra C# Word-dokumentmallen bästa praxis.

Nyckelfunktioner:

  • Multi-Source Support: Använd data från objekt, databaser, XML, JSON och CSV för att skapa anpassade Word-dokument med C#.
  • High Performance: Effektivt hantera stora dataset och massoperationer för dynamisk Word-dokumentgenerering med .NET Core.
  • Anpassningsbara mallar: Skapa mallar med platsinnehavare för datainsamling, med hjälp av .NET Word mail fusion automation-funktioner.

Inställningar

För att börja installera Aspose.Words med NuGet:

PM> Install-Package Aspose.Words

Generera Word-dokument från mall med C#-objekt

Låt oss börja med att populera en Word-mall med C#-objekt. Vi kommer att skapa ett Word-dokument (DOC/DOCX) med följande platsinnehavare:

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

I det här exemplet är sender ett exempel på en klass som vi kommer att använda för att populera malen med hjälp av C# genererar Word-dokumentet från databasen-metoden.

Därefter kommer vi att använda rapporteringsmotorn i Aspose.Words för att generera Word-dokumentet från mall och instans i Sender-klassen genom att följa följande steg:

  • Skapa ett exempel på Dokumentet klasser och initialisera det med Word-templets väg.
  • Skapa och initialisera ett objekt i Sender-klassen.
  • Instantera den ReportingEngine Klassen är.
  • Populera templaten med hjälp av Anmälning.BuildReport(), som tar dokumentets instans, datakälla och namnet på datakällan som parametrar.
  • Spara det genererade Word-dokumentet med hjälp av Föregående inläggSave().

Här är kodprovet som visar hur man genererar ett Word-dokument från en mall i C#.

Utgång

Generera Word-dokument från en XML-data källor i C#

För att generera ett Word-dokument från en XML-datakälla använder vi en mer komplex Word-mall med följande platsinnehavare:

<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>

XML-datakällan som används i detta exempel visas nedan.

Om du vill skapa ett Word-dokument från en XML-datakälla följer du följande steg:

  • Skapa en instans av Dokument-klassen och initialisera den med Word-mallens väg.
  • Skapa ett exempel på XmlDataSource klasser och initialisera den med XML-filen.
  • Uppdatera ReportingEngine klass.
  • Använd ReportingEngine.BuildReport()-metoden för att populera Word-mall.
  • Spara det genererade Word-dokumentet med Document.Save()-metoden.

Här är kodprovet som visar hur man genererar ett Word-dokument från en XML-datakälla i C#.

Utgång

Generera Word-dokument från en JSON Data Source i C#

Nästa, låt oss utforska hur man genererar ett Word-dokument med en JSON-datakälla.I det här exemplet kommer vi att skapa en lista över kunder som segmenteras av deras chefer:

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

Den motsvarande JSON-datakällan vi kommer att använda för att populera malen är nedan:

För att generera Word-dokumentet från JSON kommer vi att använda JsonDataSource Klassen för att ladda datakällan, och de återstående stegen kommer att följa den föregående strukturen. Här är kodmönstret som visar hur man genererar ett Word-dokument från JSON-mallen i C#.

Utgång

Generera Word-dokument från CSV Data Source i C#

För att generera Word-dokumentet från en CSV-källa använder vi följande Word-mall:

<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>

Templatet kommer att populeras med hjälp av följande CSV-data:

Nu, låt oss granska C#-koden. stegen förblir samma utom för en nyckelskillnad: vi kommer att använda CsvDataSource Klassen för att ladda CSV-data. Följande kodprov illustrerar hur man genererar Word-dokumentet från en CSV data källa.

Utgång

Försök Aspose.Words för .NET gratis

Du kan försöka Aspose.Words för .NET Använd en fri Tillfällig licens.

slutsatser

I den här artikeln har du lärt dig hur du genererar Word-dokument från mallar med C#. Du har utforskat hur man använder olika datakällor som objekt, XML, JSON och CSV för dynamisk dokumentgenerering i .NET. För ytterligare insikter om möjligheter till .NET Word template processing, dyka in i Dokumentation, och känna sig fri att komma ut genom vår Forumet.

More in this category