Generate Word from template in C#

Automatyzacja generacji dokumentów jest kluczowa dla firm, które chcą tworzyć dynamiczne raporty, faktury i listy. z Aspose.Words Mail Merge dla .NET, można efektywnie zlokalizować szablony Word z danymi z różnych źródeł, w tym obiektów, CSV, JSON i XML. Ten przewodnik przejdzie przez korzystanie z Mail Merge w C# dla ukierunkowanych i automatycznych przepływów pracy dokumentów, skupiając się na dynamiczne tworzenie dokumentu Word z C# .NET.

Tabela zawartości

Przegląd Mail Merge dla .NET

Plugin Aspose.Words Mail Merge dla .NET umożliwia programistom tworzenie dostosowanych dokumentów z wstępnie zdefiniowanych szablonów zawierających pola połączenia. ta integracja jest przeznaczona do bezprzewodowego użytkowania w środowiskach .NET, oferując możliwości:

  • Dynamicznie zlokalizuj szablony z danymi, wspierając .NET framework generację dokumentu Word.
  • Efektywnie wykonuje generację dokumentów masowych, wykorzystując rozwiązanie połączenia poczty .NET dla dokumentów programu Word.
  • Zapewnij spójne formatowanie na wszystkich wyjściach, poprawiając C# najlepsze praktyki szablonu dokumentu Word.

Kluczowe cechy:

  • Multi-Source Support: Użyj danych z obiektów, baz danych, XML, JSON i CSV do tworzenia dostosowanych dokumentów Word za pomocą C#.
  • Wysoka wydajność: Efektywnie obsługuje duże zestawy danych i masowe operacje dla dynamicznej generacji dokumentów Word z .NET Core.
  • Dostosowalne szablony: Tworzenie szablonów z lokatorami do wprowadzania danych, korzystając z możliwości automatyzacji połączenia wiadomości pocztowej .NET Word.

ustawienia

Aby rozpocząć, zainstaluj Aspose.Words za pomocą NuGet:

PM> Install-Package Aspose.Words

Generuj dokument z szablonu za pomocą obiektów C#

Zacznijmy od populowania szablonu Word za pomocą obiektów C#. Stworzymy dokument Word (DOC/DOCX) z następującymi posiadaczami lokalizacji:

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

W tym przykładzie sender jest przykładem klasy, którą będziemy używać do populowania szablonu za pomocą C# generuje dokument Word z bazy danych podejścia.

Następnie będziemy korzystać z silnika raportowania Aspose.Words do generowania dokumentu Word z szablonu i przykładu klasy Sender, postępując zgodnie z następującymi krokami:

  • Stwórz przykład z Dokumenty klasę i inicjalizuj ją w drodze szablonu Słowa.
  • Stwórz i inicjalizuj obiekt klasy Sender.
  • Zacznij od ReportingEngine w klasie.
  • Wykorzystywanie szablonu Informacje o budowie(), który przyjmuje przykład dokumentu, źródło danych i nazwę źródła danych jako parametry.
  • Zachowaj generowany dokument Word za pomocą Informacje na temat (Save().

Oto próbka kodu, która pokazuje, jak generować dokument Word z szablonu w C#.

Wyjście

Generuj dokument Word z źródła danych XML w C#

Aby stworzyć dokument Word z źródła danych XML, będziemy używać bardziej złożonego szablonu Word z następującymi posiadaczami lokalizacji:

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

Źródło danych XML używane w tym przykładzie jest wyświetlane poniżej.

Aby utworzyć dokument Word z źródła danych XML, postępuj zgodnie z następującymi krokami:

  • Stwórz przykład klasy Dokument i inicjalizuj go w trybie szablonu Słowa.
  • Stwórz przykład z XmlDataSource klasyfikuj i inicjalizuj go drogą pliku XML.
  • Następnie zainstaluj klasę ReportingEngine.
  • Użyj metody ReportingEngine.BuildReport(), aby zlokalizować szablon Word.
  • Zapisz generowany dokument Word za pomocą metody Document.Save.

Oto próbka kodu, która pokazuje, jak generować dokument Word z źródła danych XML w C#.

Wyjście

Generuj dokument Word z źródła danych JSON w C#

Następnie przeanalizujmy, jak tworzyć dokument Word za pomocą źródła danych JSON. W tym przykładzie stworzymy listę klientów segmentowanych przez ich menedżerów:

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

Poniżej znajduje się odpowiedni źródło danych JSON, które będziemy używać do populacji szablonu:

Aby wygenerować dokument Word z JSON, będziemy używać JsonDataSource klasę do ładowania źródła danych, a pozostałe kroki będą śledzić poprzednią strukturę. oto próbka kodu, która pokazuje, jak generować dokument Word z szablonu JSON w C#.

Wyjście

Generuj dokument Word z źródła danych CSV w C#

Aby wygenerować dokument Word z źródła CSV, będziemy używać następującego szablonu Word:

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

Formularz zostanie zamieszczony za pomocą następujących danych CSV:

Teraz przeanalizujmy kod C#. kroki pozostają takie same, z wyjątkiem jednej kluczowej różnicy: będziemy używać CsvDataSource W poniższym próbce kodu przedstawiono sposób generowania dokumentu Word z źródła danych CSV.

Wyjście

Spróbuj Aspose.Words dla .NET za darmo

Możesz spróbować Aspose.Words dla .NET Używanie darmowego Licencja tymczasowa.

konkluzja

W tym artykule dowiedziałeś się, jak generować dokumenty Word z szablonów za pomocą C#. Odkryłeś sposób wykorzystywania różnych źródeł danych, takich jak obiekty, XML, JSON i CSV do dynamicznej generacji dokumentów w .NET dokumentacja, Czuć się wolny, aby przejść przez naszą Forum.

More in this category