In modernen Anwendungen ist es entscheidend, Word-Dokumente sofort für verschiedene Zwecke wie Abrechnungen, Rechnungen, Briefe usw. zu erstellen. Die Microsoft Word-Vorlagendokumentfunktion bietet eine leistungsstarke Möglichkeit, Konsistenz und Effizienz zu gewährleisten. Die manuelle Befüllung dieser Vorlagen kann jedoch zeitaufwändig und fehleranfällig sein. Hier kommt IronWord von Iron Software ins Spiel – eine robuste .NET-Bibliothek, die entwickelt wurde, um den Prozess der programmgesteuerten Befüllung von Word-Vorlagen zu automatisieren. In diesem Artikel führen wir Sie durch die Verwendung von IronWord, um eine Word-Dokumentvorlage auszufüllen, und bieten ein praxisnahes Beispiel zur Veranschaulichung des Prozesses.

Wie man ein Word-Dokument mit einer Word-Vorlage in C# erstellt

1. Erstellen Sie ein neues Projekt in Microsoft Visual Studio.
2. Installieren Sie IronWord über den NuGet-Paketmanager.
3. Erstellen Sie ein Word-Vorlagendokument.
4. Fügen Sie Daten in ein Word-Dokument ein und speichern Sie es als neue Datei.
5. Fügen Sie dem erstellten Word-Dokument Texteffekte hinzu.

Was ist IronWord?

IronWord ist eine .NET-Bibliothek von Iron Software, die entwickelt wurde, um die Erstellung, Manipulation und Verwaltung von Microsoft Word-Dokumenten programmgesteuert zu erleichtern. Sie ermöglicht es Entwicklern, den Prozess der Erstellung von Word-Dokumenten zu automatisieren, was es einfacher macht, dynamisch Berichte, Rechnungen, Briefe und andere Dokumenttypen innerhalb ihrer Anwendungen zu erstellen.

Hauptmerkmale von IronWord

1. C# Word-Vorlage ausfüllen und Handling

IronWord ermöglicht die Verwendung von Word-Vorlagen, um Platzhalter in einem Vorlagendokument zu definieren und sie zur Laufzeit durch tatsächliche Daten zu ersetzen.

2. Textmanipulation

Sie können Text in einem Word-Dokument einfach einfügen, ersetzen oder löschen.

3. Formatierung

Die Bibliothek unterstützt verschiedene Formatierungsoptionen, darunter Schriftartenstile, Größen, Farben und Absatzausrichtung.

4. Tabellen und Bilder

IronWord ermöglicht es Ihnen, Tabellen und Bilder in Ihren Dokumenten einzufügen und zu bearbeiten.

5. Kompatibilität

Es funktioniert nahtlos mit verschiedenen Versionen von Microsoft Word und gewährleistet Kompatibilität und Benutzerfreundlichkeit.

Anwendungsfälle

• Berichtserstellung: Automatische Generierung detaillierter Berichte mit dynamischen Daten.
• Rechnungserstellung: Erstellen Sie Professional Rechnungen, indem Sie Kunden- und Transaktionsdaten eingeben.
• Vertragsmanagement: Automatisierte Erstellung von Verträgen mit personalisierten Informationen.
• Briefe und Mitteilungen: Erstellen Sie personalisierte Briefe und Mitteilungen für Kunden oder Mitarbeiter.

IronWord vereinfacht die Arbeit mit Word-Dokumenten in .NET-Anwendungen und ist ein wertvolles Werkzeug für Entwickler, die Dokumentenerstellung und -management automatisieren möchten.

Voraussetzungen

Ein kurzer Hinweis, um sicherzustellen, dass Sie Folgendes vor Beginn haben:

• Visual Studio ist auf Ihrem Computer installiert.
• Das neueste .NET Framework ist installiert.

Schritt 1: Erstellen Sie ein neues Projekt in Microsoft Visual Studio.

Nun beginnen wir mit dem Erstellen eines neuen Visual Studio-Projekts.

Wählen Sie die Konsolenanwendungsvorlage auf dem untenstehenden Bildschirm aus.

Geben Sie den Projektnamen und den Speicherort an.

Wählen Sie die .NET-Version, vorzugsweise die neueste mit Unterstützung, und klicken Sie auf Erstellen.

Schritt 2: IronWord NuGet-Paketmanager installieren.

Installieren Sie das IronWord NuGet-Paket aus dem NuGet-Paketmanager wie unten in Visual Studio gezeigt.

Alternativ installieren Sie es bitte direkt über die CLI mit dem untenstehenden Befehl.

dotnet add package IronWord --version 2024.9.1

Schritt 3: Ein Word-Vorlagendokument erstellen.

Erstellen Sie jetzt ein Word-Vorlagendokument mit einer oder zwei Seiten, das während des Word-Dokument-Erstellungsprozesses verwendet werden soll.

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}

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}

Speichern Sie nun das obige Dokument unter dem Namen Template.docx.

Schritt 4: Einfügen von Daten in ein Word-Dokument und speichern als neue Datei.

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

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

Erklärung

Der bereitgestellte Code demonstriert die Verwendung der IronWord-Bibliothek, um eine Word-Dokumentvorlage mit spezifischen Daten zu füllen. Hier ist eine kurze Erklärung:

1. Lizenzeinrichtung: Der Code beginnt mit der Festlegung des Lizenzschlüssels für IronWord , um dessen Funktionalität zu aktivieren.
2. Dateipfade: Hier werden die Pfade für die Word-Vorlage (Template.docx) und die Ausgabedatei (FilledDocument.docx) angegeben.
3. Dokumentinstanz erstellen: Es wird eine Instanz von WordDocument unter Verwendung des Vorlagenpfadverweises erstellt.
4. Ersetzungen definieren: Es wird ein Wörterbuch erstellt, in dem die Schlüssel Platzhalter in der Vorlage darstellen und die Werte die einzufügenden Daten repräsentieren.
5. Platzhalter ersetzen: Dabei wird das Wörterbuch durchlaufen und jeder Platzhalter im Dokument durch die entsprechenden Daten ersetzt.
6. Dokument speichern: Abschließend wird das aktualisierte Dokument im angegebenen Ausgabepfad gespeichert.
7. Abschlussmeldung: Es wird eine Meldung gedruckt, die bestätigt, dass das Dokument erfolgreich ausgefüllt und gespeichert wurde.

Ausgabe

Schritt 5: Texteffekte zum erstellten Word-Dokument hinzufügen.

IronWord ermöglicht es auch, verschiedene Texteffekte hinzuzufügen, wie in der folgenden Tabelle gezeigt.

Im folgenden Beispiel fügen wir dem Wort 'Iron Software' Texteffekte hinzu.

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

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

Erklärung

Der überarbeitete Code veranschaulicht die Verwendung der IronWord-Bibliothek zum Ausfüllen einer Word-Dokumentvorlage, zum Stilisieren von Text und zum Speichern des geänderten Dokuments. Hier ist eine kurze Erklärung:

1. Lizenzeinrichtung: Legt den IronWord -Lizenzschlüssel fest, um die Funktionalität zu aktivieren.
2. Dateipfade: Gibt die Pfade für die Vorlage (Template.docx) und die Ausgabedatei (glowEffect.docx) an.
3. Dokumentinstanz erstellen: Initialisiert eine WordDocument-Instanz unter Verwendung des angegebenen Vorlagenpfads.
4. Ersetzungen definieren: Erstellt ein Wörterbuch mit Platzhaltern und den entsprechenden Ersetzungswerten.
5. Platzhalter ersetzen: Durchläuft das Wörterbuch und ersetzt die Platzhalter im Dokument durch tatsächliche Daten.
6. Textstil konfigurieren: Definiert einen Textstil mit Glüheffekt und gibt Farbe und Radius an.
7. Formatierten Text hinzufügen: Fügt dem Dokument Text mit dem konfigurierten Stil hinzu.
8. Dokument speichern: Speichert das aktualisierte Dokument unter einem neuen Namen (glowEffect.docx), der den angewendeten Textstil widerspiegelt.
9. Konsolenausgabe: Es wird eine Meldung ausgegeben, um zu bestätigen, dass das formatierte Dokument gespeichert wurde.

Ausgabe

IronWord-Lizenzierung

IronWord. Sobald die Daten eingegeben sind, wird die Lizenz an die angegebene E-Mail-ID geliefert. Diese Lizenz muss am Anfang des Codes platziert werden, bevor die IronWord Bibliothek verwendet wird, wie unten gezeigt.

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

License.LicenseKey = "your Key Here"

Abschluss

IronWord bietet mehrere Vorteile bei der Erstellung von Word-Dokumenten mit Vorlagen. Es vereinfacht die Dokumentenerstellungsautomatisierung, indem es Entwicklern ermöglicht, Vorlagen programmgesteuert mit spezifischen Daten auszufüllen und so die Notwendigkeit manueller Eingaben reduziert. Dies erhöht die Effizienz und Genauigkeit, da das Risiko menschlicher Fehler minimiert wird. Darüber hinaus hilft IronWord, Konsistenz über Dokumente hinweg aufrechtzuerhalten, um sicherzustellen, dass jede erstellte Datei dem gleichen Format und der gleichen Struktur entspricht. Die Automatisierung sich wiederholender Aufgaben spart Zeit und Ressourcen, was es ideal macht, um schnell große Mengen an Dokumenten zu produzieren. IronWord steigert die Produktivität und optimiert Arbeitsabläufe in Szenarien, die eine häufige oder komplexe Dokumentenerstellung erfordern.

Indem Sie die in diesem Artikel beschriebenen Schritte befolgen und das bereitgestellte Beispiel mit IronWord nutzen, können Sie Ihre Dokumentenerstellungsanforderungen effizient verwalten und Ihren Arbeitsablauf optimieren.