Jak generowac dokument Word przy uzyciu szablonu Word w C#

Jak wygenerować dokument Worda przy użyciu szablonu Worda w języku C

1. Utwórz nowy projekt w programie Microsoft Visual Studio.
2. Zainstaluj IronWord za pomocą menedżera pakietów NuGet.
3. Utwórz dokument w formacie szablonu programu WORD.
4. Wstaw dane do dokumentu WORD i zapisz go jako nowy plik.
5. Dodaj efekty tekstowe do wygenerowanego dokumentu WORD.

Czym jest IronWord?

IronWord to biblioteka .NET firmy Iron Software, zaprojektowana w celu ułatwienia programowego tworzenia, edycji i zarządzania dokumentami Microsoft Word. Pozwala to programistom zautomatyzować proces generowania dokumentów WORD, ułatwiając dynamiczne tworzenie raportów, faktur, listów i innych rodzajów dokumentów w ramach ich aplikacji.

Wymagania wstępne

Przed rozpoczęciem pracy prosimy upewnić się, że dysponują Państwo następującymi elementami:

• Visual Studio jest zainstalowane na Twoim komputerze.
• Zainstalowano najnowszą wersję .NET Framework.

Krok 1: Utwórz nowy projekt w programie Microsoft Visual Studio.

Zacznijmy od utworzenia nowego projektu w Visual Studio.

Wybierz szablon aplikacji konsolowej na poniższym ekranie.

Podaj nazwę projektu i lokalizację.

Wybierz wersję .NET, najlepiej najnowszą z dostępną obsługą, i kliknij Utwórz.

Krok 2: Zainstaluj menedżera pakietów IronWord NuGet.

Zainstaluj pakiet IronWord NuGet z menedżera pakietów NuGet w programie Visual Studio, postępując zgodnie z poniższą instrukcją.

Alternatywnie, zainstaluj go bezpośrednio za pomocą CLI, używając poniższego polecenia.

dotnet add package IronWord --version 2024.9.1

dotnet add package IronWord --version 2024.9.1

Krok 3: Utwórz dokument w formacie szablonu WORD.

Teraz wygeneruj szablon dokumentu WORDa o objętości jednej lub dwóch stron, który zostanie wykorzystany podczas procesu generowania dokumentu WORDa.

Dear {Name},

Thanks for purchasing {product}. We are happy to serve you always. Your application dated {Date} has been approved. The product comes with an expiry date of {expiryDate}. Renew the product on or before the expiry date.

Feel free to contact {phone} or {email} for further queries.

Address: {Address}

Thank you,

{Sender}

Teraz zapisz powyższy dokument jako Template.docx.

Krok 4: Wstawianie danych do dokumentu WORD i zapisywanie jako nowy plik.

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

Imports System
Imports System.Collections.Generic
Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Set the license key for IronWord
		License.LicenseKey = "your key"

		' Define paths for the template and the output file
		Dim templatePath As String = "Template.docx"
		Dim outputPath As String = "FilledDocument.docx"

		' Create a new instance of the WordDocument class using the template path
		Dim doc As New WordDocument(templatePath)

		' Define a dictionary of placeholders and their replacements
		Dim replacements = New Dictionary(Of String, String) From {
			{"{Name}", "John Doe"},
			{"{Date}", DateTime.Now.ToString("MMMM d, yyyy")},
			{"{Address}", "123 Iron Street, Iron Software"},
			{"{product}", "IronWord"},
			{"{Sender}", "IronSoftware"},
			{"{phone}", "+123 456789"},
			{"{email}", "sale@ironsoftware.com"},
			{"{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy")}
		}

		' Replace placeholders in the document with actual data
		For Each replacement In replacements
			doc.Texts.ForEach(Function(x) x.Replace(replacement.Key, replacement.Value))
		Next replacement

		' Save the filled document
		doc.Save(outputPath)

		' Notify the user that the document has been saved successfully
		Console.WriteLine("Document filled and saved successfully.")
	End Sub
End Class

Krok 5: Dodaj efekty tekstowe do wygenerowanego dokumentu WORD.

IronWord umożliwia również dodawanie różnych efektów tekstowych, jak pokazano w tabeli poniżej.

W poniższym przykładzie dodajemy efekty tekstowe do słowa "IronSoftware".

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

Imports System
Imports System.Collections.Generic
Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Set the license key for IronWord
		License.LicenseKey = "your key"

		' Define paths for the template and the output file
		Dim templatePath As String = "Template.docx"
		Dim outputPath As String = "glowEffect.docx"

		' Create a new instance of the WordDocument class
		Dim doc As New WordDocument(templatePath)

		' Define a dictionary of placeholders and their replacements
		Dim replacements = New Dictionary(Of String, String) From {
			{"{Name}", "John Doe"},
			{"{Date}", DateTime.Now.ToString("MMMM d, yyyy")},
			{"{Address}", "123 Iron Street, Iron Software"},
			{"{product}", "IronWord"},
			{"{Sender}", "Sale,"},
			{"{phone}", "+123 456789"},
			{"{email}", "sale@ironsoftware.com"},
			{"{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy")}
		}

		' Replace placeholders in the document with actual data
		For Each replacement In replacements
			doc.Texts.ForEach(Function(x) x.Replace(replacement.Key, replacement.Value))
		Next replacement

		' Create and configure text style methods with a glow effect
		Dim textStyle As New TextStyle With {
			.TextEffect = New TextEffect() With {
				.GlowEffect = New Glow() With {
					.GlowColor = IronWord.Models.Color.Aqua,
					.GlowRadius = 10
				}
			}
		}

		' Add styled text to the document
		doc.AddText(" IronSoftware").Style = textStyle

		' Save the document with the glow effect
		doc.SaveAs(outputPath)

		' Notify the user that the document has been saved successfully
		Console.WriteLine("Styled document saved successfully.")
	End Sub
End Class

Wyjaśnienie

Zmieniony kod ilustruje wykorzystanie biblioteki IronWord do wypełnienia szablonu dokumentu WORD, formatowania tekstu i zapisania zmodyfikowanego dokumentu. Oto zwięzłe wyjaśnienie:

1. Konfiguracja licencji: Ustawia klucz licencyjny IronWord w celu włączenia funkcjonalności.
2. Ścieżki plików: Określa ścieżki do szablonu (Template.docx) i pliku wyjściowego (glowEffect.docx).
3. Utwórz instancję dokumentu: Inicjuje instancję WordDocument przy użyciu podanej ścieżki szablonu.
4. Zdefiniuj zamienniki: Tworzy słownik symboli zastępczych i odpowiadających im wartości zamiennych.
5. Zastąpienie symboli zastępczych: Przeglądanie słownika i zastępowanie symboli zastępczych w dokumencie rzeczywistymi danymi.
6. Konfiguracja stylu tekstu: definiuje styl tekstu z efektem blasku, określając kolor i promień.
7. Dodaj tekst ze stylem: Dodaje do dokumentu tekst o skonfigurowanym stylu.
8. Zapisz dokument: Zapisuje zaktualizowany dokument pod nową nazwą (glowEffect.docx), odzwierciedlającą zastosowany styl tekstu.
9. Wynik konsoli: Wyświetlany jest komunikat potwierdzający, że stylizowany dokument został zapisany.

Wynik

Licencjonowanie IronWord

IronWord. Po wprowadzeniu danych licencja zostanie dostarczona na podany adres e-mail. Licencję tę należy umieścić na początku kodu, przed użyciem biblioteki IronWord, jak pokazano poniżej.

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

Wnioski

IronWord oferuje kilka zalet związanych z tworzeniem dokumentów WORD przy użyciu szablonów. Ułatwia automatyzację tworzenia dokumentów, umożliwiając programistom programowe wypełnianie szablonów konkretnymi danymi, co ogranicza konieczność ręcznego wprowadzania danych. Zwiększa to wydajność i dokładność, ponieważ ryzyko błędu ludzkiego jest zminimalizowane. Ponadto IronWord pomaga zachować spójność między dokumentami, zapewniając, że każdy wygenerowany plik ma ten sam format i strukturę. Automatyzacja powtarzalnych zadań pozwala zaoszczędzić czas i zasoby, dzięki czemu idealnie nadaje się do szybkiego tworzenia dużych ilości dokumentów. IronWord zwiększa produktywność i usprawnia przepływ pracy w sytuacjach wymagających częstego lub złożonego generowania dokumentów.

Postępując zgodnie z instrukcjami zawartymi w tym artykułe i korzystając z podanego przykładu z wykorzystaniem IronWord, można efektywnie zarządzać potrzebami w zakresie generowania dokumentów i usprawnić przepływ pracy.