Wie man eine Word-Datei mit C# liest

In der heutigen Zeit sind Microsoft Word-Dokumente synonym mit Büroarbeit sowie beruflicher und persönlicher Kommunikation. Daher ist die programmgesteuerte Manipulation von Word-Dokumenten für Entwickler, die Aufgaben automatisieren möchten, um sie den Benutzern in ihren Anwendungen anzuzeigen, von entscheidender Bedeutung. Obwohl viele Bibliotheken verfügbar sind, sind nicht alle so robust wie andere. Jedoch ist ein solcher Anwärter, der sich von den anderen abhebt, IronWord. 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.

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

Wie man eine Word-Datei mit C&num liest;

1. Erstellen einer Konsolenanwendung in Visual Studio

2. IronWord C# DOCX-Bibliothek installieren

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

4. Text zum Word-Dokument hinzufügen

5. Schleife durch jeden Absatz mit der Paragraph-Klasse

6. Inhalt anzeigen

IronWord: Die C# DOCX-Bibliothek

IronWord ist eine flexible und skalierbare Bibliothek mit einer unkomplizierten und benutzerfreundlichen API, die den Aufwand bei der Integration von Word-Dokumenten in Anwendungen beseitigt. Egal, ob Sie ein einfaches Textdokument in Ihre Anwendung integrieren oder komplexe Tabellen und Berichte erstellen möchten, um sie den Benutzern anzuzeigen, IronWord bietet Ihnen alles.

Hier sind die bemerkenswertesten Funktionen.

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

2. Plattformübergreifende Unterstützung und Kompatibilität: IronWord ist flexibel konzipiert 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, einschließlich, aber nicht beschränkt auf Windows, Linux, macOS und Android. Es umfasst die gängigsten Plattformen und ermöglicht es Entwicklern, schnell plattformübergreifende Anwendungen 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 behebt dieses Problem jedoch, da es unabhängig von dieser Einschränkung ist. Entwickler können die volle Leistungsfähigkeit von Word-Dokumenten nutzen, ohne durch die Lizenzierung und Installation von Microsoft Word eingeschränkt zu sein.

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

5. Einfache Handhabung und umfassender Support: Zusammen mit einer leicht verständlichen API und einfachen Methodenaufrufen bietet IronWord auch Erweiterungs-API-Referenzen und Codebeispiele, um Entwicklern zu helfen, den optimalen Weg zur Nutzung von IronWord zu bestimmen.

Erstellen eines neuen Konsolenprojekts in Visual Studio

Bevor wir in das Beispiel eintauchen, lassen Sie uns mit der Erstellung eines leeren Konsolenprojekts in Visual Studio beginnen.

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

Wählen Sie als Nächstes das .NET-Framework aus, das Sie verwenden werden. In diesem Beispiel werde ich .NET 8.0 verwenden.

Nachdem das neue Konsolenprojekt erstellt und eingerichtet wurde, installieren wir unsere C# Word-Bibliothek, IronWord.

Installation von IronWord

Es gibt zwei Möglichkeiten, IronWord zu installieren.

1. Installation über den NuGet-Paket-Manager

Um es über den NuGet-Paket-Manager zu installieren, klicken Sie auf Tools und dann auf NuGet-Lösungen verwalten. Suchen Sie dann in der Suchleiste nach IronWord und installieren Sie **IronWord**.

2. Installation über die NuGet-Paket-Manager-Konsole

Eine alternative Methode ist die Installation über die NuGet Package Manager Console. Führen Sie dazu den folgenden Befehl in der Konsole aus:

Install-Package IronWord

Install-Package IronWord

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

Lizenzschlüssel

Bitte beachten Sie, dass IronWord ohne Lizenzschlüssel nicht funktioniert. Sie können eine hier im Rahmen einer kostenlosen Testversion erhalten.

Nachdem Sie einen Testschlüssel erhalten haben, stellen Sie sicher, dass diese Variable in Ihrem Projekt gesetzt 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";

IRON VB CONVERTER ERROR developers@ironsoftware.com

Word-Dokumente in C# lesen

Nach der Installation der Voraussetzungen werden wir die Einfachheit des Lesens eines Microsoft Word-Dokuments mit IronWord im folgenden Code demonstrieren.

Zunächst importieren wir den folgenden Namespace. Mit IronWord erstellen wir ein neues Dokument und fügen einen Beispieltext hinzu. Wir greifen dann auf die Absätze und den Text zu, indem wir das `WordDocument`-Objekt verwenden, um den Text innerhalb des Word-Dokuments auszugeben.

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

1. Wir erstellen zunächst ein Text-Objekt und weisen ihm die Zeichenkette "Beispieltext" zu.

2. Wir instanziieren dann ein Paragraph-Objekt und fügen das "textRunExample" hinzu.

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

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

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

6. Um den Text innerhalb des Absatzes zu erhalten, greifen wir auf die "Texts"-Eigenschaft von Paragraphs zu. Dies gibt auch eine Liste von Text zurück.

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

Konsolenausgabe

Ein vorhandenes Word-Dokument in C# lesen

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

Eingabedokument

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

Konsolenausgabe

Schlussfolgerung

In den Beispielen haben wir gezeigt, wie einfach es ist, die IronWord-Bibliothek zu verwenden, um Word-Dokumente programmatisch in C# zu manipulieren und zu lesen. Die Flexibilität und Skalierbarkeit der IronWord-Bibliothek macht sie zu einem wertvollen Werkzeug, das es Entwicklern ermöglicht, IronWord in praktischen, realen Beispielen zu verwenden, wie zum Beispiel beim Ausfüllen von Vorlagen, Erstellen von Berichten und Batch-Verarbeiten von Dokumenten. Das Verständnis, wie Word in Anwendungen integriert ist, ist wertvoll, da es den 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 es kaufen, da es eine kostenlose Testlizenz anbietet. Zusätzlich zur Benutzerfreundlichkeit bietet IronWord auch umfassende Dokumentation und 24/5 Support für Entwickler, was die ständige Frustration, der Entwickler während der Produktion gegenüberstehen könnten, vermindert. Wir bieten auch verschiedene Anleitungen und eine Reihe von Codebeispielen als Referenz an, um Ihnen den Einstieg mit IronWord zu erleichtern.

Nachdem Sie verschiedene Aspekte von IronWord mit einer Testlizenz ausprobiert haben, können Sie unsere Lite-Entwicklerlizenz erwerben, die bei 599 $ beginnt und von Lite bis Professional reicht. Bitte besuchen Sie unsere Lizenzierungsseite für weitere Informationen.