IRONWORD VERWENDEN

Wie man eine Word-Datei mit C# liest

Veröffentlicht 15. August 2024
Teilen Sie:

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 sticht ein solcher Anwärter aus der Masse hervor 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.

Dieser Artikel wird untersuchen, wie wir schnell nutzen können IronWord 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 unter Verwendung der Klasse Paragraph

  6. Inhalt anzeigen

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 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. Dokumentenmanipulation: 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 gestaltet und unterstützt Entwickler auf verschiedenen 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 beim Integrieren von Word-Dokumenten in .Net-Anwendungen ist, dass beliebte Bibliotheken wie Interop eine lizenzierte Installation von Microsoft Office erfordern. IronWord beseitigt jedoch dieses Problem, indem 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 umfangreiche Unterstützung für Formatierungen und Stile, sodass Entwickler das Dokument einzigartig gestalten können. Entwickler können sich bewerben schriftarten für ihren Text, Farben, Ausrichtungen und andere komplexe Formatierungen, wie z. B tischformen.

  5. Einfache Bedienung und umfangreiche Unterstützung: Neben einer leicht verständlichen API und einfachen Methodenanrufen bietet IronWord auch Erweiterungs-API-Referenzen und Codebeispiele, um Entwicklern zu helfen, den optimalsten Weg zur Nutzung von IronWord zu bestimmen.

Erstellen eines neuen Konsolenprojekts in Visual Studio

Bevor wir in das Beispiel eintauchen, beginnen wir damit, ein leeres Konsolenprojekt in Visual Studio.

Klicken Sie auf Konsolenanwendung, wenn Sie ein neues Projekt erstellen.

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

Geben Sie den Namen und den 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.

Wählen Sie das gewünschte .NET-Framework aus und klicken Sie auf Erstellen.

Nach dem Erstellen und Einrichten des neuen Konsolenprojekts, lassen Sie uns unsere C#-Wortbibliothek installieren, 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 Werkzeuge und dann auf `NuGet-Lösungen verwalten.` Dann suchen wir im Suchfeld nach IronWord und installieren `IronWord.`

Installieren Sie IronWord über das Verwaltungstool NuGet-Pakete für die Lösung, indem Sie IronWord in der Suchleiste des NuGet-Paketmanagers eingeben, dann das Projekt auswählen und auf die Schaltfläche Installieren klicken.

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
VB   C#

Lizenzschlüssel

Bitte beachten Sie, dass IronWord ohne Lizenzschlüssel nicht funktioniert. Hier können Sie einen als Teil eines kostenloser Test.

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
VB   C#

Word-Dokumente in C# lesen

Nach der Installation der erforderlichen Komponenten werden wir die Einfachheit des Lesens eines Microsoft Word-Dokuments mithilfe von IronWord for .NET demonstrieren. IronWord im folgenden Code.

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 im Word-Dokument auszudrucken.

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
VB   C#

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

  1. Zuerst erstellen wir ein Text-Objekt und weisen ihm den String "Beispieltext" zu.

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

  3. Wir erstellen auch ein WordDocument-Objekt, benennen es `WordDocument doc,` und übergeben das `paragraphExample`-Objekt, 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 in dem soeben erstellten Word-Dokument zuzugreifen, greifen wir auf die Eigenschaft "Paragraphs" des Objekts WordDocument 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 der Paragraphs zu. Dies gibt auch eine Liste von Text zurück.

  7. Schließlich weisen wir den Text einer Zeichenfolgenvariablen mit dem Namen "content" zu und geben ihn auf der Konsole aus.

Konsolenausgabe

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

Ein bestehendes 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

Eingabebeispiel: Langform-Wortdokument

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
VB   C#

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

Konsolenausgabe

Konsolenausgabe

Schlussfolgerung

IronWord-Lizenzierungsinformationen

Durch die Beispiele haben wir gezeigt, wie einfach es ist, die IronWord Bibliothek zur programmgesteuerten Bearbeitung und zum Lesen von Word-Dokumenten in C#. Die Flexibilität und Skalierbarkeit der IronWord-Bibliothek machen sie zu einem wertvollen Werkzeug, das Entwicklern ermöglicht, IronWord in praktischen, realen Beispielen zu verwenden, wie das Ausfüllen von Vorlagen, Erstellen von Berichten und Batch-Verarbeitung 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.

Außerdem können Entwickler die umfangreichen Funktionen von IronWord für einen bestimmten Zeitraum vor dem Kauf testen, da es ein kostenlos testen lizenz. Zusätzlich zur Benutzerfreundlichkeit bietet IronWord auch umfassende Dokumentation und 24/5 Support für Entwickler, wodurch die ständige Frustration der Entwickler angesichts der Produktion gemildert wird. Wir bieten auch verschiedene Tutorials und eine Reihe von Codebeispiele als Referenz, um Ihnen den Einstieg mit IronWord zu erleichtern.

Nach dem Testen verschiedener Aspekte von IronWord Mit einer Testlizenz können Sie unsere Lite Developer-Lizenz erwerben, die bei $599 beginnt und sich von Lite bis Professional erweitert. Bitte beziehen Sie sich auf unsere Lizenzierung seite für weitere Informationen.

< PREVIOUS
3 C# Word-Bibliotheken (Aktualisierte Liste für Entwickler)
NÄCHSTES >
Wie man ein Word-Dokument mit C# manipuliert

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

Gratis NuGet-Download Downloads insgesamt: 6,643 Lizenzen anzeigen >