Zum Fußzeileninhalt springen
IRONWORD VERWENDEN

Wie man eine DOCX-Datei in C# erstellt

Viele Anwendungen in der heutigen digitalen Umgebung erfordern die Fähigkeit, Dokumente automatisch zu erstellen und zu ändern. Die Fähigkeit, mit DOCX-Dateien zu erstellen und zu arbeiten, ist nützlich, egal ob Sie ein Enterprise-Reporting-System, ein Dokumentenverwaltungssystem oder einfach wiederkehrende Aufgaben automatisieren. 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 IronWord.
  3. Um Dokumentdateien zu erstellen, fügen Sie einen neuen TextRun hinzu.
  4. Erstellen Sie einen neuen Body und ein neues Dokument.
  5. Füllen Sie den Body mit Inhalten (Absätze, Tabellen, etc.).
  6. Verwenden Sie WordDocument, um ein neues WordDocument zu erstellen.
  7. Das Zuweisen des Document-Objekts zur TextRun-, Paragraph-Dokumenteigenschaft speichert die Änderungen.

Das DOCX-Format kennenlernen

Bevor wir in das Coding eintauchen, lassen Sie uns 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 zur programmgesteuerten Manipulation relativ einfach.

IronWord

Iron Software entwickelte die Word-Dokument-Bibliothek bekannt als IronWord. Wenn es darum geht, starke Fähigkeiten zur Manipulation von Word-Dokumenten in .NET-Anwendungen anzubieten, brilliert IronWord. Um .NET C#-Entwicklern dabei zu helfen, die Fähigkeit zum Erstellen, Lesen und Bearbeiten von Word- und DOCX-Dokumenten in ihre Programme zu integrieren, ist IronWord eine robuste Word-Dokument-Bibliothek.

Funktionen von IronWord

  • Erstellen und Bearbeiten von DOC und DOCX: IronWord eliminiert die Anforderung für Office Interop oder die Installation von Microsoft Word, indem Sie Word-Dokumente direkt innerhalb Ihrer .NET-Projekte erstellen und bearbeiten können.
  • Öffnen, Bearbeiten eines bestehenden Dokuments und Speichern einer Word-Datei und Docx: Die Struktur des Word-Dokuments kann angepasst werden, einschließlich Seitenkonfiguration (Hintergrundfarbe, Ränder, Papiergröße und Orientierung).
  • 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 ist für C#, F# und VB.NET entwickelt. Es funktioniert in verschiedenen Umgebungen, wie Docker, iOS, Android, Windows und Linux.
  • Weltweit vertrauen Millionen von Ingenieuren auf uns: IronWord ist ein Bestandteil der Iron Suite, die aus neun .NET API Office-Dokument-Produkten besteht. Entwickler verwenden es weltweit, um Word-Dokumente zu erstellen, anzuzeigen und zu bearbeiten.

Um mehr über IronWord zu erfahren, klicken Sie hier.

Erstellen eines neuen Projekts in Visual Studio

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

Wie man eine DOCX-Datei in C# erstellt: Abbildung 1 - Neues Projekt erstellen

Geben Sie den Projektnamen in das vorgesehene Textfeld ein, nachdem Sie den Dateispeicherort gewählt haben. Klicken Sie dann auf die Schaltfläche Erstellen und wählen Sie das erforderliche .NET-Framework, wie im folgenden Beispiel gezeigt.

Wie man eine DOCX-Datei in C# erstellt: Abbildung 2 - Projektname und Dateipfad konfigurieren

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. Das Internet, Windows oder die Konsole können alle genutzt 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 Paket-Manager-Schnittstelle ein, um Zugriff auf die Paketverwaltungs-Terminalkonsole zu erhalten.

Install-Package IronWord

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

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

Es gibt auch die Package Manager-Methode. Mithilfe der NuGet-Paketmanager-Option von Visual Studio ist es möglich, das Paket direkt in die Lösung zu installieren. Sie können sehen, wie Sie den NuGet-Paketmanager im Bild unten starten.

Wie man eine DOCX-Datei in C# erstellt: Abbildung 4 - Wie man den NuGet-Paketmanager findet

Verwenden Sie das Suchfeld der NuGet-Website, um Pakete zu finden. Alles, was wir tun müssen, ist, "IronWord" im Paketmanager nachzuschlagen, wie das Bild unten zeigt:

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

Die Liste der relevanten Suchergebnisse wird in der obigen Abbildung angezeigt. Um die Software auf Ihrem Computer zu installieren, passen Sie einfach diese Einstellungen an.

Erstellen von DOCX mit IronWord

Instanziieren Sie ein WordDocument-Objekt, um ein neues Word-Dokument zu starten. Um das Dokument zu initialisieren, können Sie jedes Objekt verwenden, das die Dokumentstruktur ausmacht, wie einen Absatz, eine Tabelle oder einen Abschnitt. Hier folgt eine einfache Illustration im folgenden Code-Snippet:

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

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

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

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

            // Export and save the DOCX file to the specified path.
            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, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

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

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

Wir können mit der Hilfe der TextRun-Klasse Text zum Dokument hinzufügen, die es uns ermöglicht, den Text mit der AddTextRun-Methode in das Absatzobjekt zu übergeben. Dann erstellen wir ein neues WordDocument-Objekt, um eine neue DOCX-Datei zu erstellen. Dann können wir das neue DOCX-Dokument mit der SaveAs-Methode am gewünschten Ort speichern. Unten ist die Ausgabe aus dem obigen Code erzeugt.

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

Um mehr über IronWord-Code zu erfahren, klicken Sie hier.

Abschluss

Wir haben uns angesehen, wie man in diesem Leitfaden ein DOCX-Dokument mit C# generiert. Die Grundlagen des DOCX-Formats wurden besprochen, zusammen mit dem Open XML SDK und der DocX-Bibliothek, und es wurden Beispiele gegeben, wie man sie verwendet, um DOCX-Dateien zu erstellen, zu bearbeiten und zu speichern.

All diese Tools und Methoden versetzen Sie in eine starke Position, um eine Vielzahl von Dokumentenerstellungsaufgaben in Ihren C#-Projekten zu bewältigen. Das Lernen der Dokumenterstellung in C# ist eine nützliche Fähigkeit, die Ihnen in verschiedenen Situationen helfen wird, sei es bei der Automatisierung der Berichtserstellung, der Entwicklung von Dokumentenverwaltungssystemen oder einfach beim Erstellen von Vorlagen für Endbenutzer.

Für Entwickler, die mit .NET C# arbeiten, ist IronWord eine leistungsstarke und flexible Word-Dokument-Bibliothek. Es ermöglicht Entwicklern, Word- (DOCX-) Dokumente in ihren Apps problemlos zu lesen, zu schreiben und zu bearbeiten. Die benutzerfreundliche API von IronWord erleichtert die Verarbeitung von Word-Dokumenten. Ohne dass Microsoft Word installiert sein muss oder von Office Interop abhängt, können Entwickler Word-Dateien direkt innerhalb ihrer .NET-Projekte erstellen und bearbeiten. Das Hinzufügen von Text, Absätzen und anderen Elementen zu neuen Word-Dokumenten wird einfach gemacht.

IronWord ist $799, wenn es erstmals herauskommt. Darüber hinaus können Kunden, die eine einjährige Mitgliedschaftsgebühr zahlen, Unterstützung und Updates zu Produkten erhalten. Gegen eine Gebühr bietet IronWord einen Schutz gegen ungebremste Weiterverbreitung. Um mehr über die ungefähren Kosten zu erfahren, gehen Sie auf diese Seite. Erfahren Sie mehr über Iron Software, indem Sie auf diesen Link klicken.

Häufig gestellte Fragen

Wie kann ich eine DOCX-Datei in C# erzeugen?

Um eine DOCX-Datei in C# zu erzeugen, können Sie die IronWord-Bibliothek nutzen. Beginnen Sie mit der Installation des IronWord NuGet-Pakets, importieren Sie die erforderlichen Namespaces und initialisieren Sie ein WordDocument-Objekt. Sie können dann Inhalte mit Methoden wie AddTextRun hinzufügen und das Dokument mit der SaveAs-Methode speichern.

Welche Vorteile bietet IronWord bei der DOCX-Dateierzeugung?

IronWord bietet mehrere Vorteile bei der DOCX-Dateierzeugung, einschließlich der Fähigkeit, Dokumente ohne Microsoft Word zu erstellen und zu bearbeiten, Unterstützung für mehrere Plattformen und eine benutzerfreundliche API, die den Dokumenterstellungsprozess vereinfacht.

Kann ich mit IronWord Bilder zu einer DOCX-Datei hinzufügen?

Ja, IronWord erlaubt Ihnen das Hinzufügen von Bildern zu einer DOCX-Datei. Sie können die Methode AddImage verwenden, um Bilder in Ihr Dokument einzufügen, was die visuelle Attraktivität und Funktionalität Ihrer DOCX-Dateien verbessern kann.

Ist es möglich, vorhandene DOCX-Dateien mit IronWord zu bearbeiten?

Ja, IronWord ermöglicht es Ihnen, vorhandene DOCX-Dateien zu bearbeiten. Sie können eine DOCX-Datei mit IronWord öffnen, deren Inhalt, Struktur oder Formatierung ändern und dann die Änderungen speichern.

Unterstützt IronWord die Dokumenterstellung unter Linux?

Ja, IronWord unterstützt die Dokumenterstellung unter Linux als Teil seiner plattformübergreifenden Funktionalitäten, sodass Entwickler DOCX-Dateien auf verschiedenen Betriebssystemen einschließlich Linux erstellen und bearbeiten können.

Welche Schritte sind erforderlich, um IronWord in einem C#-Projekt einzurichten?

Die Einrichtung von IronWord in einem C#-Projekt umfasst die Installation des IronWord NuGet-Pakets über den NuGet-Paketmanager, das Importieren notwendiger Namespaces in Ihren Code und die Nutzung der IronWord-API zur Ausführung von Dokumenterstellungs- und Bearbeitungsaufgaben.

Wie handhabt IronWord die Kompatibilität von DOCX-Dateien?

IronWord ist darauf ausgelegt, mit dem DOCX-Format kompatibel zu sein, um sicherzustellen, dass Dateien, die mit IronWord erstellt oder bearbeitet wurden, in Microsoft Word und anderen kompatiblen Textverarbeitungsprogrammen geöffnet und verwendet werden können.

Jordi Bardia
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, ...
Weiterlesen