VS 2022 Programmgesteuerte Erstellung neuer Word-Dokumente (Tutorial)
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"
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

Erklärung
- Zuerst importieren wir die IronWord Library und ihre Modelle im Beispielcode.
- Wir erstellen eine neue Variable
Text. Diese Variable ermöglicht es uns, Text in das Word-Dokument einzufügen. - Anschließend fügen wir
textRunzuParagraphhinzu. Dies ermöglicht es uns, den Text einfach zu bearbeiten, indem wir zwischen den beiden unterscheiden. - Wir übergeben den Parameter
paragraphan eine neue KlasseWordDocument, 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

Erklärung des Codes
- Wie im obigen Beispiel erstellen wir das Objekt
Textund fügen den Beispieltext für das Dokument hinzu. - Anschließend erstellen wir ein neues
TextStyle-Objekt und weisen der EigenschaftIsItalicden Werttruezu, wodurch angegeben wird, dass der Text kursiv sein soll. - Dasselbe tun wir für die Variable
boldText, indem wirtrueder EigenschaftIsBoldzuweisen. - Anschließend ordnen wir die Variablen
TextStyleihren jeweiligen VariablenTextzu. - Wir erstellen eine Variable
Paragraphund rufen die MethodeAddTextauf, um den kursiven und fettgedruckten Text hinzuzufügen. - Wir fügen den Absatz mithilfe der Methode
AddParagraphzum 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

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.
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.




