In der heutigen Zeit sind Microsoft Word-Dokumente gleichbedeutend mit Büroarbeit sowie professioneller und persönlicher Kommunikation. Daher ist die programmgesteuerte Manipulation von Word-Dokumenten entscheidend für Entwickler, die Aufgaben automatisieren möchten, um sie Benutzern in ihren Anwendungen anzuzeigen. Obwohl viele Bibliotheken verfügbar sind, sind nicht alle so robust wie andere. Jedoch sticht ein Mitbewerber, der sich von den anderen abhebt, IronWord hervor. IronWord ist eine zuverlässige und robuste C# Word DOCX-Bibliothek, die einfach zu verwenden und zu verstehen ist und die Arbeit mit Word-Dokumenten vereinfacht.

Dieser Artikel untersucht, wie wir IronWord schnell nutzen können, um Word-Dokumente mit kurzen Beispielen zu lesen.

How To Read a Word File Using C#

1. Erstellen Sie eine Konsolenanwendung in Visual Studio

2. Installieren Sie die IronWord C# DOCX-Bibliothek

3. Erstellen Sie ein neues Word-Dokument mit der WordDocument-Klasse

4. Fügen Sie dem Word-Dokument Text hinzu

5. Schleifen Sie durch jeden Absatz mit der Paragraph-Klasse

6. Zeigen Sie den Inhalt an

IronWord: Die C# DOCX-Bibliothek

IronWord ist eine flexible und skalierbare Bibliothek mit einer unkomplizierten und benutzerfreundlichen API, die den Aufwand für die Integration von Word-Dokumenten in Anwendungen beseitigt. Egal, ob Sie ein einfaches Text-Word-Dokument in Ihre Anwendung integrieren oder komplexe Tabellen und Berichte zur Anzeige für Benutzer erstellen möchten, IronWord bietet alles, was Sie benötigen.

Hier sind seine bemerkenswertesten Funktionen:

1. Dokumentenmanipulation: IronWord ermöglicht es Entwicklern, Word-Dokumente problemlos zu bearbeiten. Egal, ob Benutzer Textabsätze oder komplexere Strukturen wie Tabellen und Bilder einfügen möchten, IronWord kann alles erledigen.

2. Plattformübergreifende Unterstützung und Kompatibilität: IronWord wurde entwickelt, um flexibel zu sein und unterstützt Entwickler auf mehreren Plattformen. Es unterstützt verschiedene .NET Core (8, 7, 6, 5 und 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) und sogar Azure. Darüber hinaus können Entwickler IronWord auf verschiedenen Plattformen und Systemen nutzen, darunter, aber nicht beschränkt auf, Windows, Linux, macOS und Android. Es deckt die gängigsten Plattformen ab und ermöglicht Entwicklern, plattformübergreifende Anwendungen schnell zu erstellen.

3. Unabhängigkeit von Microsoft Office: Ein häufiges Problem bei der Integration von Word-Dokumenten in .NET-Anwendungen ist, dass beliebte Bibliotheken wie Interop eine lizenzierte Installation von Microsoft Office erfordern. IronWord umgeht dieses Problem, indem es unabhängig von dieser Einschränkung ist. Entwickler können die Leistungsfähigkeit von Word-Dokumenten voll ausschöpfen, ohne durch die Lizenzierung und Installation von Microsoft Word eingeschränkt zu sein.

4. Formatierungsoptionen: IronWord bietet umfangreiche Unterstützung für Formatierung und Gestaltung, sodass Entwickler das Dokument individuell gestalten können. Entwickler können Schriften auf ihren Text anwenden, Farben, Ausrichtungen und andere komplexe Formatierungen, wie Tabellenstile.

5. Benutzerfreundlichkeit und umfassende Unterstützung: Neben einer leicht verständlichen API und einfachen Methodenaufrufen bietet IronWord auch API-Erweiterungsreferenzen und Beispielcode, um Entwicklern zu helfen, die optimale Nutzung von IronWord herauszufinden.

Ein neues Konsolenprojekt in Visual Studio erstellen

Bevor wir mit dem Beispiel beginnen, lassen Sie uns ein leeres Konsolenprojekt in Visual Studio erstellen.

Wir geben dann einen Namen und einen Speicherort für das Projekt an.

Wählen Sie anschließend das .NET-Framework, das Sie verwenden werden. In diesem Beispiel werde ich .NET 8.0 verwenden.

Nach dem Erstellen und Einrichten des neuen Konsolenprojekts installieren wir unsere C#-Word-Bibliothek IronWord.

IronWord installieren

Es gibt zwei Möglichkeiten, IronWord zu installieren.

1. Installation über den NuGet Package Manager

Um es über den NuGet-Paket-Manager zu installieren, klicken Sie auf Werkzeuge und dann auf Manage NuGet Packages for Solution. Wir suchen dann in der Suchleiste nach IronWord und installieren **IronWord**.

2. Installation über die NuGet Package Manager-Konsole

Eine alternative Methode besteht darin, es über die NuGet Package Manager-Konsole zu installieren. Führen Sie dazu den folgenden Befehl in der Konsole aus:

Install-Package IronWord

Lizenzschlüssel

Bitte beachten Sie, dass IronWord ohne Lizenzschlüssel nicht funktioniert; Sie können hier als Teil einer kostenlosen Testversion einen erhalten.

Nach Erhalt eines Testschlüssels stellen Sie sicher, dass diese Variable in Ihrem Projekt festgelegt ist.

// 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"

' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

Reading Word Documents in C#

Nachdem wir die Voraussetzungen installiert haben, werden wir die Einfachheit des Lesens eines Microsoft Word-Dokuments mithilfe von IronWord im folgenden Code demonstrieren.

Zuerst importieren wir die notwendigen Namespaces. Mit IronWord erstellen wir ein neues Dokument und fügen Beispieltext hinzu. Wir greifen dann auf die Absätze und Texte zu, indem wir das WordDocument-Objekt verwenden, um den Text im Word-Dokument auszugeben.

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Create text run with sample text
Dim textRunExample As New Text("Sample text")

' Create a paragraph and add the text run to it
Dim paragraphExample As New Paragraph()
paragraphExample.AddChild(textRunExample)

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

' Export the document as a DOCX file
doc.SaveAs("document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Create text run with sample text
Dim textRunExample As New Text("Sample text")

' Create a paragraph and add the text run to it
Dim paragraphExample As New Paragraph()
paragraphExample.AddChild(textRunExample)

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

' Export the document as a DOCX file
doc.SaveAs("document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Lassen Sie uns die Methoden und Parameter untersuchen, um Word-Dateien aus dem obigen Code zu lesen.

1. Wir erstellen zuerst ein Text-Objekt und weisen den String "Beispieltext" zu.

2. Dann instanziieren wir ein Paragraph-Objekt und fügen das "textRunExample" hinzu.

3. Wir instanziieren auch ein WordDocument-Objekt, benennen es WordDocument doc, und übergeben ihm paragraphExample, um ein neues Word-Dokument zu erstellen, das den Absatz enthält.

4. Der Code speichert das Word-Dokument mit dem Dateinamen "document.docx" zur späteren Verwendung.

5. Um auf die Absätze im gerade erstellten Word-Dokument zuzugreifen, greifen wir auf die "Paragraphs"-Eigenschaft des WordDocument-Objekts zu. Die "Paragraphs"-Eigenschaft ist eine Liste. Daher rufen wir eine foreach-Schleife auf, um sie zu durchlaufen.

6. Um den Text im Absatz zu erhalten, greifen wir auf die "Texts"-Eigenschaft von Paragraphs zu. Dies liefert auch eine Liste von Text.

7. Schließlich weisen wir den Text einer String-Variablen namens "content" zu und geben ihn in der Konsole aus.

Konsolenausgabe

Reading an existing Word document in C#

Im vorherigen Beispiel haben wir programmgesteuert ein neues Word-Dokument erstellt und seinen Inhalt gelesen. Wir können ähnliche Schritte befolgen, um ein bestehendes Word-Dokument zu lesen, indem wir ein paar Codeänderungen vornehmen.

Eingabedokument

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Load an existing Word document
Dim doc As New WordDocument("existing_document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Load an existing Word document
Dim doc As New WordDocument("existing_document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Der Hauptunterschied zwischen den beiden Beispielen ist der Parameter, der an das WordDocument-Objekt übergeben wird. Anstatt ein neues Dokument zu erstellen, laden wir eine bestehende Word-Datei hinein. Der Rest ist wie im anderen Beispiel.

Konsolenausgabe

Abschluss

In den Beispielcode haben wir gezeigt, wie einfach es ist, die IronWord-Bibliothek zu verwenden, um Word-Dokumente programmgesteuert in C# zu manipulieren und zu lesen. Die Flexibilität und Skalierbarkeit der IronWord-Bibliothek machen sie zu einem wertvollen Werkzeug, das es Entwicklern ermöglicht, IronWord in praktischen, realen Beispielen zu nutzen, wie z. B. das Ausfüllen von Vorlagen, das Generieren von Berichten und die Stapelverarbeitung von Dokumenten. Das Verständnis dafür, wie Word in Anwendungen integriert wird, ist wertvoll, da es Entwicklern mehr Lösungen für ihre Probleme bietet.

Darüber hinaus können Entwickler die umfangreichen Funktionen von IronWord für einen bestimmten Zeitraum testen, bevor sie kaufen, da sie eine kostenlose Testversion bietet. Zusätzlich zur Benutzerfreundlichkeit kommt IronWord auch mit umfassender Dokumentation und 24/5 Unterstützung für Entwickler, um die ständige Frustration, der Entwickler in der Produktion gegenüberstehen, zu lindern. Wir bieten auch verschiedene Schulungen und eine Reihe von Codebeispielen als Referenz an, um Ihnen den Einstieg mit IronWord zu erleichtern.

Nach dem Testen verschiedener Aspekte von IronWord mit einer Testlizenz können Sie unsere Lite-Entwicklerlizenz erwerben, die bei $599 beginnt und von Lite bis Professional aufwärts geht. Bitte beziehen Sie sich auf unsere Lizenzierungsseite für weitere Informationen.