Dokumente werden im digitalen Zeitalter zunehmend digital. Dokumente im Geschäftsumfeld werden oft mit Microsoft Word und seinen dokumentbasierten Word-Dateien in Verbindung gebracht. Das Schreiben und Bearbeiten von Microsoft Word-Dokumenten ist die Grundlage für den Informationsaustausch in großen Organisationen geworden. Allerdings kann das manuelle Erstellen und Bearbeiten von Dokumenten ein mühsamer Prozess sein; auch die automatische Word-Generierung programmgesteuert ist keine leichte Aufgabe, da viele Open-Source-Bibliotheken auf Microsoft Office Word als Abhängigkeit angewiesen sind.

Die Verwaltung und Erstellung von Word-Dokumenten muss jedoch nicht so schwierig sein. IronWord ist eine C# Word Library, die nicht von Microsoft Office Word abhängt und es Benutzern ermöglicht, das gesamte Dokument anzupassen sowie die Dokumentenerstellung und das Erstellen von Dokumentvorlagen programmgesteuert zu ermöglichen.

In der heutigen Anleitung werde ich kurz erklären, wie man ein Microsoft Word-Dokument programmgesteuert mit IronWord erstellt und kurze Beispiele bereitstellen.

IronWord: Eine C# Word-Bibliothek

IronWord ist eine äußerst zuverlässige und benutzerfreundliche C# Docx-Bibliothek, die Entwicklern ermöglicht, Word-Dokumente mit C# zu erstellen und zu bearbeiten, ohne traditionelle Abhängigkeiten wie Microsoft Office oder Word Interop zu benötigen. Zusätzlich bietet sie umfassende Dokumentation und unterstützt vollständig .NET 8, 7, 6, Framework, Core und Azure, was sie universell kompatibel mit den meisten Anwendungen macht. Dieses Maß an Flexibilität macht es zu einer ausgezeichneten Wahl für jede Anwendung, mit der Sie möglicherweise arbeiten.

Einrichten der Umgebung

In diesem Beispiel erstellen wir eine Konsolenanwendung mit Visual Studio und zeigen, wie man leere Word-Dokumente erstellt und sie mit der IronWord Library bearbeitet. Bevor wir mit diesem nächsten Schritt fortfahren, stellen Sie sicher, dass Visual Studio installiert ist.

Zuerst erstellen wir eine neue Konsolenanwendung.

Dann geben wir einen Projektnamen ein und speichern den Speicherort wie unten gezeigt.

Wählen Sie abschließend das gewünschte Framework.

Die Installation der C# Word-Bibliothek

Nach dem Erstellen der leeren Konsolenanwendung laden wir IronWord über den NuGet Package Manager herunter.

Klicken Sie auf "Manage NuGet Packages", dann suchen Sie im "Browse"-Tab nach IronWord, wie unten gezeigt.

Installieren Sie es anschließend auf das neu erstellte Projekt.

Alternativ können Sie den folgenden Befehl in der Befehlszeile eingeben, um IronWord zu installieren.

Install-Package IronWord

Jetzt, da alles eingerichtet und bereit ist, gehen wir zu einem Beispiel über, wie Word-Dokumente erstellt werden.

Lizenzschlüssel

Bitte denken Sie daran, dass IronWord einen Lizenzschlüssel für den Betrieb benötigt. Sie können einen Schlüssel als Teil einer kostenlosen Testversion erhalten, indem Sie diesen Link besuchen.

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

Nachdem Sie einen Testschlüssel erhalten haben, setzen Sie diese Variable in Ihrem Projekt.

Erstellen eines neuen Word-Dokuments

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

        // Create a new Word document with the paragraph
        WordDocument doc = new WordDocument(paragraph);

        // Export docx
        doc.SaveAs("document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

        // Create a new Word document with the paragraph
        WordDocument doc = new WordDocument(paragraph);

        // Export docx
        doc.SaveAs("document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

		' Create a new Word document with the paragraph
		Dim doc As New WordDocument(paragraph)

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

		' Create a new Word document with the paragraph
		Dim doc As New WordDocument(paragraph)

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Erklärung

1. Zuerst importieren wir die IronWord Library und ihre Modelle im Beispielcode.
2. Wir erstellen eine neue Text Variable. Diese Variable ermöglicht es uns, Text in das Word-Dokument einzufügen.
3. Dann fügen wir die textRun zu einem Paragraph hinzu. Dies ermöglicht es uns, den Text einfach zu bearbeiten, indem wir zwischen den beiden unterscheiden.
4. Wir übergeben den paragraph Parameter an eine neue WordDocument Klasse, um ein neues Dokumentobjekt zu erstellen.
5. Schließlich speichern wir das Dokument als "document.docx" in einer Word-Datei.

Im vorherigen Beispiel haben wir ein Word-Dokument mit einfachem Text erstellt. Lassen Sie uns ein Beispiel mit fortgeschritteneren Funktionen machen, wie z. B. der Anpassung des Textes und dem Hinzufügen von Texteffekten.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

		' Load an existing docx
		Dim doc As New WordDocument("document.docx")

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As New Paragraph()
		paragraph.AddText(introText)
		paragraph.AddText(italicText)
		paragraph.AddText(boldText)

		' Add paragraph to the document
		doc.AddParagraph(paragraph)

		' Export the document
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

		' Load an existing docx
		Dim doc As New WordDocument("document.docx")

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As New Paragraph()
		paragraph.AddText(introText)
		paragraph.AddText(italicText)
		paragraph.AddText(boldText)

		' Add paragraph to the document
		doc.AddParagraph(paragraph)

		' Export the document
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Erklärung des Codes

1. Wie im obigen Beispiel erstellen wir das Text Objekt und fügen den Beispieltext für das Dokument hinzu.
2. Dann erstellen wir ein neues TextStyle Objekt und weisen die Eigenschaft IsItalic als true zu, was darauf hinweist, dass der Text kursiv sein soll.
3. Dasselbe machen wir für die boldText Variable, indem wir true der Eigenschaft IsBold zuweisen.
4. Dann ordnen wir die TextStyle Variablen ihren jeweiligen Text Variablen zu.
5. Wir erstellen eine Paragraph Variable und rufen die AddText Methode auf, um den kursiven und fettgedruckten Text hinzuzufügen.
6. Wir fügen den Absatz dem Dokument mit der AddParagraph Methode hinzu.
7. Schließlich speichern wir das Dokument als "save_document.docx".

Das obige Beispiel zeigt die Schriftarten und Stile, die Entwickler mit IronWord verwenden können. Neben kursiven und fettgedruckten Texteffekten bietet IronWord auch andere Funktionen, um sicherzustellen, dass Entwickler alle Optionen haben, um in verschiedenen Szenarien einzigartige Word-Dokumente zu erstellen.

Abschluss

Unsere Demonstrationen zeigten, wie einfach es ist, die IronWord-Bibliothek zu verwenden, um Word-Dokumente in C# programmgesteuert zu erstellen. Die Flexibilität und Skalierbarkeit der Bibliothek machen sie zu einem wertvollen Werkzeug für Entwickler in realen Szenarien, wie z.B. die Anpassung von Text, Schriftart und Stil in einem Word-Dokument. Das Verständnis, wie Word mit anderen Anwendungen integriert wird, bietet Entwicklern zusätzliche Lösungen für ihre Herausforderungen.

IronWord bietet eine kostenlose Testlizenz.