IRONWORD VERWENDEN

VS 2022 Programmgesteuerte Erstellung neuer Word-Dokumente (Tutorial)

Aktualisiert:Juli 28, 2025

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 Library

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.

Installation der C# Word Library

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"

$vbLabelText $csharpLabel

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

$vbLabelText $csharpLabel

VS 2022 Programmgesteuert Neues Word-Dokument erstellen (Tutorial): Abbildung 6 - Ausgabe aus dem obigen Beispiel

Erklärung

Zuerst importieren wir die IronWord Library und ihre Modelle im Beispielcode.
Wir erstellen eine neue Text-Variable. Diese Variable ermöglicht es uns, Text in das Word-Dokument einzufügen.
Dann fügen wir den textRun zu einem Paragraph hinzu. Dies ermöglicht es uns, den Text einfach zu bearbeiten, indem wir zwischen den beiden unterscheiden.
Wir übergeben den paragraph Parameter an eine neue WordDocument-Klasse, um ein neues Dokumentobjekt zu erstellen.
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

$vbLabelText $csharpLabel

VS 2022 Programmgesteuert Neues Word-Dokument erstellen (Tutorial): Abbildung 7 - Ausgabe aus dem obigen Beispielcode

Erklärung of code

Wie im obigen Beispiel erstellen wir das Text-Objekt und fügen den Beispieltext für das Dokument hinzu.
Dann erstellen wir ein neues TextStyle-Objekt und weisen der Eigenschaft IsItalic den Wert true zu, was anzeigt, dass der Text kursiv sein soll.
Dasselbe tun wir für die boldText-Variable, indem wir der Eigenschaft IsBold den Wert true zuweisen.
Dann weisen wir die TextStyle-Variablen ihren jeweiligen Text-Variablen zu.
Wir erstellen eine Paragraph-Variable und rufen die AddText-Methode auf, um den kursiven und fettgedruckten Text hinzuzufügen.
Wir fügen den Absatz mit der AddParagraph-Methode dem Dokument hinzu.
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

VS 2022 Programmgesteuert Neues Word-Dokument erstellen (Tutorial): Abbildung 8 – IronWord Lizenzinformationen

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. der 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 stellt eine kostenlose Testlizenz zur Verfügung.

Häufig gestellte Fragen

Wie kann ich ein Microsoft Word-Dokument programmatisch in C# erstellen?

Sie können ein Microsoft Word-Dokument programmatisch in C# mit der IronWord-Bibliothek erstellen. Initialisieren Sie ein WordDocument-Objekt, fügen Sie erforderliche Inhalte hinzu und verwenden Sie die SaveAs-Methode, um es als .docx-Datei zu exportieren.

Welche Vorteile bietet die Verwendung von IronWord gegenüber Microsoft Office Interop bei der Erstellung von Word-Dokumenten?

IronWord bietet Vorteile gegenüber Microsoft Office Interop, indem es keine Microsoft Office-Installation erfordert und eine größere Flexibilität sowie einfachere Integration über verschiedene Plattformen hinweg ohne Abhängigkeit von Office bietet.

Wie installiere ich IronWord in Visual Studio?

Um IronWord in Visual Studio zu installieren, öffnen Sie den NuGet-Paket-Manager, suchen Sie nach IronWord und installieren Sie es in Ihr Projekt. Alternativ können Sie die Befehlszeile mit Install-Package IronWord verwenden.

Kann ich Text in einem Word-Dokument mit IronWord formatieren?

Ja, Sie können Text in einem Word-Dokument mit IronWord formatieren, indem Sie das TextStyle-Objekt verwenden, um verschiedenen Textstile wie Kursiv und Fett auf Textelemente anzuwenden.

Ist IronWord mit .NET und Azure kompatibel?

Ja, IronWord ist vollständig mit .NET 8, 7, 6, Framework, Core und Azure kompatibel, was es vielseitig für verschiedene Anwendungen macht.

Wie kann ich Installationsprobleme mit IronWord beheben?

Wenn Sie auf Installationsprobleme mit IronWord stoßen, stellen Sie sicher, dass Sie eine kompatible Version von Visual Studio und .NET verwenden und dass Ihr NuGet-Paket-Manager aktualisiert ist. Überprüfen Sie Ihre Internetverbindung und versuchen Sie die Installation erneut.

Was wird benötigt, um mit der Erstellung von Word-Dokumenten mit IronWord zu beginnen?

Um mit der Erstellung von Word-Dokumenten mit IronWord zu beginnen, importieren Sie die IronWord-Bibliothek und deren Modelle in Ihr C#-Projekt. Initialisieren Sie dann ein WordDocument-Objekt, um mit dem Aufbau Ihres Dokuments zu beginnen.

Wie kann ich programmatisch Absätze zu einem Word-Dokument mit IronWord hinzufügen?

Sie können Absätze zu einem Word-Dokument programmatisch mit IronWord hinzufügen, indem Sie Paragraph-Objekte erstellen, Text zu ihnen hinzufügen und sie in das WordDocument einfügen.

Jordi Bardia

Jetzt mit dem Ingenieurteam chatten

Software Ingenieur

Jordi ist am besten in Python, C# und C++ versiert. Wenn er nicht bei Iron Software seine Fähigkeiten einsetzt, programmiert er Spiele. Mit Verantwortung für Produkttests, Produktentwicklung und -forschung trägt Jordi mit immensem Wert zur kontinuierlichen Produktverbesserung bei. Die abwechslungsreiche Erfahrung hält ihn gefordert und engagiert, ...