IRONWORD VERWENDEN

Wie man DOCX-Dateien in C# erstellt

Veröffentlicht 3. April 2024
Teilen Sie:

Einführung

Viele Anwendungen in der heutigen digitalen Umgebung erfordern die Fähigkeit, Dokumente automatisch zu erstellen und zu ändern. Die Möglichkeit, DOCX-Dateien zu erstellen und mit ihnen zu arbeiten, ist nützlich, wenn Sie ein Berichtssystem auf Unternehmensebene oder ein Dokumentenverwaltungssystem aufbauen oder einfach nur wiederkehrende Tätigkeiten automatisieren wollen. In diesem Tutorial tauchen wir in die Welt der C#-Dokumentenerstellung ein und untersuchen die robusten Bibliotheken und Programmiermethoden, die in C# zur Erstellung von DOCX-Dateien verwendet werden können.

Wie man eine DOCX-Datei in C# erstellt;

  1. Installieren Sie das NuGet-Paket IronWord.

  2. Nehmen Sie die erforderlichen Namespaces und importieren Sie sie aus dem IronWord.

  3. Um Dokumentdateien zu erzeugen, fügen Sie einen neuen TextRun hinzu.

  4. Erstellen Sie einen neuen Body und ein neues Dokument.

  5. Füllen Sie den Body mit Inhalt(absätze, Tabellen, usw.).

  6. Erstellen Sie mit WordDocument ein neues WordDocument.

  7. Wenn Sie der Eigenschaft TextRun, Paragraph Document das Document-Objekt zuweisen, werden die Änderungen gespeichert.

Das DOCX-Format kennenlernen

Bevor wir uns mit der Kodierung befassen, sollten wir klären, was eine DOCX-Datei ist. Microsoft Word und andere Textverarbeitungsprogramme speichern Dokumente im DOCX-Dateiformat. Es basiert auf dem ZIP-komprimierten XML-basierten[Office Open XML(OOXML) Standard](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.). Dies ermöglicht die Verwendung von APIs von Microsoft und anderen Entwicklern, um sie relativ einfach programmatisch zu manipulieren.

IronWord

Iron Software hat die Word-Dokumentenbibliothek, bekannt als IronWord. Wenn es darum geht, leistungsstarke Funktionen für die Bearbeitung von Word-Dokumenten in .NET-Anwendungen anzubieten. IronWord ist eine robuste Word-Dokumentenbibliothek, die .NET-C#-Entwicklern hilft, Word- und DOCX-Dokumente in ihren Programmen zu erstellen, zu lesen und zu ändern.

Merkmale von IronWord

  • Erstellen und bearbeiten Sie DOC und DOCX: IronWord macht Office Interop oder die Installation von Microsoft Word überflüssig, indem es Ihnen ermöglicht, Word-Dokumente direkt in Ihren .NET-Projekten zu erstellen und zu bearbeiten.
  • Öffnen, Bearbeiten eines vorhandenen Dokuments und Speichern einer Word-Datei und Docx: Die Word-Dokumentenstruktur ist anpassbar, einschließlich der Seitenkonfiguration(hintergrundfarbe, Ränder, Papierformat und Ausrichtung).
  • Wörter und Bilder einfügen: Mit der einfachen API können Sie schnell Text und Grafiken zu Ihren Word-Dokumenten hinzufügen.
  • Plattformübergreifende Unterstützung: IronWord ist kompatibel mit .NET 8, 7, 6, Core, Standard oder Framework und wurde für C#, F# und VB.NET entwickelt. Es funktioniert in verschiedenen Umgebungen, wie Docker, iOS, Android, Windows und Linux.
  • Weltweit verlassen sich Millionen von Ingenieuren auf uns: IronWord ist eine Komponente der Iron Suite, die aus neun .NET API Office-Dokumentenprodukten besteht. Entwickler auf der ganzen Welt verwenden es zum Erstellen, Anzeigen und Ändern von Word-Dokumenten.

    Mehr über das IronWord erfahren Sie unter*hier.

Erstellen eines neuen Projekts in Visual Studio

Um die Visual Studio-Anwendung zu starten, wählen Sie im Menü Datei die Option Datei. Klicken Sie auf "Neues Projekt" und wählen Sie dann "Konsolenanwendung"

Wie man eine DOCX-Datei in C# erstellt: Abbildung 1 - Erstellen eines neuen Projekts

Geben Sie den Projektnamen in das vorgesehene Textfeld ein, nachdem Sie den Speicherort der Datei ausgewählt haben. Als Nächstes klicken Sie, wie im Beispiel unten zu sehen, auf die Schaltfläche Erstellen und wählen das gewünschte .NET-Framework aus.

Wie man DOCX-Dateien in C# erstellt: Abbildung 2 - Konfigurieren des Projektnamens und des Dateipfads

Die Organisation des Visual Studio-Projekts hängt dann von der ausgewählten Anwendung ab. Um Code hinzuzufügen und die Anwendung zu erstellen, öffnen Sie einfach die Datei program.cs. Die Internetanwendung, Windows oder die Konsole können alle verwendet werden.

Danach kann die Bibliothek hinzugefügt und der Code getestet werden.

IronWord-Bibliothek installieren

Verwendung des Visual Studio Tools Wählen Sie NuGet Package Manager aus dem Menü Tools. Geben Sie die Paketverwaltungsschnittstelle ein, um Zugriff auf die Terminal-Konsole für die Paketverwaltung zu erhalten.

Install-Package IronWord

Nach dem Herunterladen und Installieren des Pakets kann es nun im laufenden Projekt verwendet werden.

Wie man eine DOCX-Datei in C# erstellt: Abbildung 3 - Installieren von IronWord mit der Paketmanager-Konsole

Es gibt auch die Methode des Paketmanagers. Die Installation des Pakets direkt in die Lösung ist mit der Option NuGet Package Manager von Visual Studio möglich. Wie Sie den NuGet Package Manager starten, sehen Sie in der folgenden Abbildung.

Wie man DOCX-Dateien in C# erstellt: Abbildung 4 - So finden Sie den NuGet-Paketmanager

Verwenden Sie das Suchfeld der NuGet-Website, um nach Paketen zu suchen. Alles, was wir tun müssen, ist, "IronWord" in der Paketverwaltung zu suchen, wie der folgende Screenshot zeigt:

Wie man eine DOCX-Datei in C# erstellt: Abbildung 5 - Installieren von IronWord mit dem NuGet-Paketmanager

Die Liste der relevanten Suchergebnisse ist in der obigen Abbildung dargestellt. Um die Software auf Ihrem Rechner zu installieren, müssen Sie lediglich diese Einstellungen vornehmen.

DOCX mit IronWord erstellen

Instanziieren Sie ein WordDocument-Objekt, um ein neues Word-Dokument zu beginnen. Für die Initialisierung des Dokuments können Sie jedes Objekt verwenden, das die Dokumentstruktur bildet, z. B. einen Absatz, eine Tabelle oder einen Abschnitt. Der folgende Codeschnipsel veranschaulicht dies auf einfache Weise:

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
Imports IronWord
Imports IronWord.Models
Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			' Create a new document
			Dim doc As New WordDocument(paragraph)
			' Export the DOCX file
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
VB   C#

Wir können dem Dokument mit Hilfe der Klasse TextRun Text hinzufügen, die es uns ermöglicht, den Text mit Hilfe der Methode AddTextRun an das Absatzobjekt zu übergeben. Dann erstellen wir ein neues WordDocument-Objekt, um eine neue DOCX-Datei zu erstellen. Anschließend können wir mit der SaveAs-Methode das neue DOCX-Dokument an dem gewünschten Ort speichern. Nachfolgend sehen Sie die mit dem obigen Code erzeugte Ausgabe.

Wie man DOCX-Dateien in C# erstellt: Abbildung 6 - Ausgegebene PDF-Datei aus dem vorherigen Code

Mehr über den IronWord-Code erfahren Sie unter*hier.

Schlussfolgerung

In diesem Handbuch haben wir uns angesehen, wie man mit C# eine DOCX-Dokumentendatei erzeugt. Die Grundlagen des DOCX-Formats wurden besprochen, ebenso wie das Open XML SDK und die DocX-Bibliothek, und es wurden Beispiele gegeben, wie man sie zum Erzeugen, Bearbeiten und Speichern von DOCX-Dateien verwendet.

All diese Werkzeuge und Methoden versetzen Sie in die Lage, eine Vielzahl von Dokumentenerstellungsaufgaben in Ihren C#-Projekten zu bewältigen. Das Erlernen der Dokumentenerstellung in C# ist eine nützliche Fähigkeit, die Ihnen in verschiedenen Situationen helfen wird, egal ob Sie die Erstellung von Berichten automatisieren, Dokumentenverwaltungssysteme entwickeln oder einfach nur Vorlagen für Endbenutzer erstellen.

Für Entwickler, die mit .NET C# arbeiten,IronWord ist eine leistungsstarke und anpassungsfähige Word-Dokumentenbibliothek. Es ermöglicht Entwicklern das Lesen, Schreiben und Bearbeiten von Word(DOCX) dokumente in ihren Anwendungen einfach zu bearbeiten. Die benutzerfreundliche API von IronWord erleichtert die Bearbeitung von Word-Dokumenten. Ohne dass Microsoft Word installiert sein muss oder auf Office Interop angewiesen ist, können Entwickler Word-Dateien direkt in ihren .NET-Projekten erstellen und bearbeiten. Das Hinzufügen von Text, Absätzen und anderen Elementen zu neuen Word-Dokumenten ist ganz einfach.

IronWord ist $749, wenn es zum ersten Mal herauskommt. Darüber hinaus können Kunden, die einen einjährigen Mitgliedsbeitrag zahlen, Unterstützung und Aktualisierungen zu Produkten erhalten. IronWord bietet gegen eine Gebühr einen Schutz vor unkontrollierter Weiterverbreitung. Weitere Informationen über die ungefähren Kosten finden Sie unter dieser Adresse*Seite. Mehr über Iron Software erfahren Sie, wenn Sie hier klickenLink.

< PREVIOUS
C# Word-Automatisierung durchführen
NÄCHSTES >
Programmgesteuerte Erstellung von Word-Dokumenten in VB .NET

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

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