Zum Fußzeileninhalt springen
IRONWORD VERWENDEN

Wie man eine Word-Datei mit C# liest

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.

Wie man eine Word-Datei mit C# liest

  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: 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: Mit IronWord können Entwickler Word-Dokumente mit Leichtigkeit manipulieren. 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 ist so konzipiert, dass es flexibel ist und Entwickler auf mehreren Plattformen unterstützt. 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 umfassende Unterstützung für Formatierung und Stil, sodass Entwickler das Dokument einzigartig gestalten können. Developers can apply fonts to their text, colors, alignments, and other complex formatting, such as table styles.

  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.

Neue Projektkonsole öffnen

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

Den Namen und den Speicherortspfad für das Projekt angeben.

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

Das gewünschte .NET-Framework auswählen und auf Erstellen klicken.

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 Package Manager zu installieren, klicken Sie auf Tools und dann auf NuGet-Pakete für Lösung verwalten. Wir suchen dann nach IronWord in der Suchleiste und installieren **IronWord**.

IronWord mit dem NuGet Package Manager installieren, indem Sie IronWord in der Suchleiste des NuGet Package Managers suchen, dann das Projekt auswählen und auf die Installieren-Schaltfläche klicken.

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"
$vbLabelText   $csharpLabel

Word-Dokumente in C# lesen

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 den Text mithilfe des WordDocument-Objekts zu, 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
$vbLabelText   $csharpLabel

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

Konsolenausgabe, die den aus dem Word-Dokument doc gelesenen Text anzeigt.

Ein bestehendes Word-Dokument in C# lesen

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

Eingabebeispiel: Langform-Word-Dokument

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
$vbLabelText   $csharpLabel

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

Konsolenausgabe

Abschluss

IronWord-Lizenzinformationen

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. Along with ease of use, IronWord also comes with thorough documentation and 24/5 support for developers, alleviating the constant frustration developers might face in the face of production. We also offer various tutorials and a range of code examples for reference to help you get started with IronWord.

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.

Häufig gestellte Fragen

Wie kann ich ein Word-Dokument mit C# lesen?

Sie können IronWord verwenden, um ein Word-Dokument in C# zu lesen. Laden Sie einfach das Dokument mit der WordDocument-Klasse und iterieren Sie dann durch Absätze und Textruns, um auf den Textinhalt zuzugreifen und ihn anzuzeigen.

Was ist eine zuverlässige C#-Bibliothek zum Lesen von Word-Dokumenten?

IronWord ist eine zuverlässige C#-Bibliothek, die für das Lesen und Manipulieren von Word-Dokumenten entwickelt wurde. Sie bietet eine unkomplizierte API, die die Integration von Word-Dokument-Funktionen in Anwendungen vereinfacht.

Muss ich Microsoft Office installiert haben, um Word-Dokumente in C# zu lesen?

Nein, IronWord erfordert nicht die Installation von Microsoft Office. Es arbeitet unabhängig und ermöglicht es Ihnen, Word-Dokumente zu manipulieren, ohne eine lizenzierte Version von Office zu benötigen.

Wie kann ich eine C#-Bibliothek zum Lesen von Word-Dokumenten in Visual Studio installieren?

Sie können IronWord über den NuGet-Paket-Manager in Visual Studio installieren, indem Sie nach 'IronWord' suchen und 'Installieren' wählen oder mit der NuGet-Paket-Manager-Konsole den Befehl Install-Package IronWord verwenden.

Welche Plattformen werden von IronWord für die Manipulation von Word-Dokumenten unterstützt?

IronWord unterstützt eine Vielzahl von Plattformen, einschließlich .NET Core (8, 7, 6, 5 und 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) und Azure, und ist kompatibel mit Windows, Linux, macOS und Android.

Kann ich bestehende Word-Dokumente mit einer C#-Bibliothek manipulieren?

Ja, mit IronWord können Sie sowohl neue als auch bestehende Word-Dokumente programmatisch lesen und ändern, was Ihnen die volle Kontrolle über den Dokumentinhalt und die Struktur gibt.

Gibt es eine kostenlose Testversion für IronWord?

Ja, IronWord bietet eine kostenlose Testlizenz. Entwickler können diese Testversion nutzen, um die Funktionen zu erkunden und zu beurteilen, ob sie für ihre Projekte geeignet ist, bevor sie eine Vollversion erwerben.

Wie kann ich Word-Dokumente in andere Formate mit C# konvertieren?

Sie können IronWord verwenden, um Word-Dokumente in verschiedene Formate zu konvertieren, indem Sie dessen API nutzen, um Dokumente in Formate wie PDF, HTML und mehr zu exportieren, obwohl die Konversionsspezifika variieren können.

Was sind einige häufige Anwendungsfälle für IronWord in C#-Anwendungen?

IronWord wird häufig für Aufgaben wie das Ausfüllen von Vorlagen, das Erstellen von Berichten, die Stapelverarbeitung von Dokumenten und die Integration von Word-Dokument-Funktionen in .NET-Anwendungen verwendet.

Welche Unterstützungsoptionen stehen Benutzern von IronWord zur Verfügung?

IronWord bietet 24/5-Support sowie umfassende Dokumentation, Tutorials und Codebeispiele, um Entwicklern zu helfen, die Bibliothek effektiv zu nutzen.

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