IRONWORD VERWENDEN

VS 2022 Programmatisch Neue Word-Dokumente Erstellen (Tutorial)

Veröffentlicht 16. Dezember 2024
Teilen Sie:

Dokumente werden in der digitalen Ära zunehmend digital. Dokumente im geschäftlichen Umfeld werden häufig mit Microsoft Word und dessen dateibasierten Word-Dokumenten in Verbindung gebracht. Schreiben und BearbeitenMicrosoft WordDokumente sind zur Grundlage für den Informationsaustausch in großen Organisationen geworden. Das manuelle Erstellen und Bearbeiten von Dokumenten kann jedoch ein mühsamer Prozess sein. Die automatisierte programmatische Generierung von Word-Dokumenten ist ebenfalls keine einfache Aufgabe, da viele Open-Source-Bibliotheken auf Microsoft Office Word als Abhängigkeit angewiesen sind.

Das Verwalten und Erstellen von Word-Dokumenten muss nicht so schwierig sein. IronWordist eine C#-Bibliothek für Word, die nicht von Microsoft Office Word abhängig ist und es Benutzern ermöglicht, das gesamte Dokument anzupassen sowie Dokumente zu generieren und Dokumentvorlagen programmgesteuert zu erstellen.

Im heutigen Tutorial werde ich kurz erläutern, wie man mit IronWord programmatisch ein Microsoft Word-Dokument erstellt, und kurze Beispiele bereitstellen.

IronWord: Eine C# Word-Bibliothek

Defektes Bild Von Pixabay hinzufügen, aus Ihren Dateien auswählen oder ein Bild hierher ziehen.

IronWord ist eine außergewöhnlich zuverlässige und benutzerfreundliche C# Docx-Bibliothek, die Entwicklern ermöglicht, Word-Dokumente mit C zu erstellen und zu bearbeiten, ohne dass herkömmliche Abhängigkeiten wie Microsoft Office oder Word Interlope benötigt werden. Zusätzlich bietet es umfangreiche Dokumentation und vollständige Unterstützung für .NET 8, 7, 6, Framework, Core und Azure, was es universell mit den meisten Anwendungen kompatibel macht. Diese Flexibilität macht es zu einer ausgezeichneten Wahl für jede Anwendung, mit der Sie möglicherweise zu tun haben.

Einrichten der Umgebung

Für dieses Beispiel erstellen wir eine Konsolenanwendung unter Verwendung vonVisual Studiound demonstrieren Sie, wie man leere Word-Dokumente erstellt und diese mithilfe der IronWord-Bibliothek manipuliert. Bevor wir diesen nächsten Schritt fortsetzen, stellen Sie sicher, dass Visual Studio installiert ist.

Zuerst erstellen wir eine neue Konsolenanwendung.

Defektes Bild Von Pixabay hinzufügen, aus Ihren Dateien auswählen oder ein Bild hierher ziehen.

Geben Sie dann einen Projektnamen ein und speichern Sie den Speicherort, wie unten gezeigt.

Defektes Bild Von Pixabay hinzufügen, aus Ihren Dateien auswählen oder ein Bild hierher ziehen.

Wählen Sie schließlich das gewünschte Framework aus.

Defektes Bild Von Pixabay hinzufügen, aus Ihren Dateien auswählen oder ein Bild hierher ziehen.

Installation der C# Word-Bibliothek

Nach dem Erstellen der leeren Konsolenanwendung laden wir herunterIronWordüber den NuGet-Paket-Manager.

Klicken Sie auf „NuGet-Pakete verwalten“ und suchen Sie dann im „Durchsuchen-Reiter“ nach IronWord, wie unten gezeigt.

Defektes Bild Von Pixabay hinzufügen, aus Ihren Dateien auswählen oder ein Bild hierher ziehen.

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

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

Install-Package IronWord
Install-Package IronWord
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord
VB   C#

Da nun alles eingerichtet und bereit ist, lassen Sie uns zu einem Beispiel für das Erstellen von Word-Dokumenten übergehen.

Lizenzschlüssel

Bitte denken Sie daran, dass IronWord für den Betrieb einen Lizenzierungsschlüssel benötigt. Sie können einen Schlüssel als Teil einer kostenlosen Testversion erhalten, indem Sie diese Seite besuchenlink.

//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";
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

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

Erstellen eines neuen Word-Dokuments

using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models
' Create textrun
Private textRun As New Text("Sample text")
Private paragraph As New Paragraph()
paragraph.AddChild(textRun)
' Create a new Word document
Dim doc As New WordDocument(paragraph)
' Export docx
doc.SaveAs("document.docx")
VB   C#

VS 2022 Programmatisch neue Word-Dokumente erstellen (Tutorial): Abbildung 6 - Ausgabe aus dem obigen Beispiel

Erläuterung

  1. Zuerst importieren wir die IronWord-Bibliothek und ihre Modelle im Beispielcode.

  2. Wir erstellen dann eine neue "Text"-Variable. Diese Variable ermöglicht es uns, Text zum Word-Dokument hinzuzufügen.

  3. Wir fügen dann den "Text" einem "Paragraph" hinzu. Dadurch können wir den Text einfach manipulieren, indem wir zwischen den beiden unterscheiden.

  4. Wir übergeben dann 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 das Anpassen des Textes und das Hinzufügen von Texteffekten.

using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
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;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");
using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
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;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models
#Region ""
IronWord.License.LicenseKey = "YOUR-KEY"
'#End Region
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
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
Dim paragraph As New Paragraph()
' Add text
paragraph.AddText(introText)
paragraph.AddText(italicText)
paragraph.AddText(boldText)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")
VB   C#

VS 2022 Programmatische Erstellung neuer Word-Dokumente (Tutorial): Abbildung 7 - Ausgabe des obigen Beispielcodes

Erläuterung des Codes

  1. Wie im obigen Beispiel erstellen wir das "Text"-Objekt und fügen den Beispieltext für das Dokument hinzu.

  2. Anschließend erstellen wir ein neues "TextStyle"-Objekt und weisen die Eigenschaft "IsItalic" als wahr zu, was anzeigt, dass der Text kursiv sein soll.

  3. Wir machen das auch für die Variable „boldText“, indem wir der Eigenschaft „IsBold“ den Wert true zuweisen.

  4. Anschließend weisen wir die "TextStyle"-Variablen ihren jeweiligen "Text"-Variablen zu.

  5. Wir erstellen dann eine Variable "Paragraph" und rufen die Methode "AddText" auf, um den kursiven und fetten Text hinzuzufügen.

  6. Wir fügen schließlich den Absatz mit der Methode "AddParagraph" dem Dokument hinzu.

  7. Speichern Sie dann das Dokument als "save_document.docx".

    Das obige Beispiel zeigt die Schriftarten und Stile, die Entwickler mit IronWord verwenden können, abgesehen von Kursiv- und Fettschrifteffekten. IronWord bietet auch andere Funktionen, um sicherzustellen, dass Entwickler alle Optionen haben, um in allen Szenarien einzigartige Word-Dokumente zu erstellen.

Schlussfolgerung

VS 2022 Programmatische Erstellung neuer Word-Dokumente (Tutorial): Abbildung 8 - Lizenzinformationen zu IronWord

Unsere Demonstrationen haben gezeigt, wie einfach es ist, dieIronWordBibliothek zur programmgesteuerten Erstellung von Word-Dokumenten in C#. Die Flexibilität und Skalierbarkeit der Bibliothek machen sie zu einem wertvollen Werkzeug für Entwickler in praxisnahen Szenarien, wie zum Beispiel beim Anpassen von Text, Schriftart und Stil in einem Word-Dokument. Das Verständnis dafür, wie Word sich mit anderen Anwendungen integriert, bietet Entwicklern zusätzliche Lösungen für ihre Herausforderungen.

IronWord bietet einekostenlose Testlizenz.

< PREVIOUS
ASP .NET Core Importieren & Exportieren einer Word-Datei
NÄCHSTES >
Wie man Text in Word mit C# ausrichtet

Sind Sie bereit, loszulegen? Version: 2024.12 gerade veröffentlicht

Gratis NuGet-Download Downloads insgesamt: 8,594 Lizenzen anzeigen >