Jak odczytac plik Word za pomoca C#
In today's era, Microsoft Word documents are synonymous with office work and professional and personal communication. Hence, programmatically manipulating Word documents is critical for developers looking to automate tasks to display to users in their applications. Although there are many available libraries, not all are as robust as the others. However, one such contender that stands out from the rest is IronWord. IronWord is a reliable and robust C# Word DOCX library that is easy to use and understand, and simplifies working with Word documents.
This article will explore how we can quickly utilize IronWord to read Word documents with short examples.
How To Read a Word File Using C
-
Utwórz aplikację konsolową w Visual Studio
-
Zainstaluj bibliotekę IronWord C# DOCX
-
Create a new Word document using the WordDocument class
-
Add text to the Word document
-
Loop through each paragraph using the Paragraph class
- Display the contents
IronWord: The C# DOCX Library

IronWord is a flexible and scałable library with a straightforward and easy-to-use API that eliminates the hassle of integrating Word documents into applications. Whether you want to add and integrate a simple text word document to your application or create complex tables and reports to display to users, IronWord has everything covered.
Here are its most notable features:
-
Document Manipulation: IronWord allows developers to manipulate Word documents with ease. Whether users want to insert paragraphs of text or more complex structures such as tables and images, IronWord can do it all.
-
Cross-Platform Support and Compatibility: IronWord is designed to be flexible and supports developers on multiple platforms. It supports various .NET Core (8, 7, 6, 5, and 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+), and even Azure. Furthermore, developers can utilize IronWord on different platforms and systems, including but not limited to Windows, Linux, macOS, and Android. It covers the most common platforms and allows developers to build cross-platform applications quickly.
-
Independence from Microsoft Office: One common trouble when integrating Word documents in .NET applications is that popular libraries such as Interop require a licensed installation of Microsoft Office. However, IronWord alleviates that problem by being independent of that restriction. Developers can fully leverage the power of Word documents without being restricted by the license and installation of Microsoft Word.
-
Formatting Options: IronWord offers extensive support for formatting and styling, allowing developers to make the document unique. Developers can apply fonts to their text, colors, alignments, and other complex formatting, such as table styles.
- Ease of Use and Extensive Support: Along with an easy-to-understand API and straightforward method calls, IronWord also provides extension API references and code examples to help developers determine the most optimal way to utilize IronWord.
Creating a New Console Project in Visual Studio
Before we dive into the example, let's start by creating a blank console project in Visual Studio.

We then provide a name and a save location for the project.

Next, select the .NET framework that you will be using. In this example, I will be using .NET 8.0.

After creating and setting up the new console project, let's install our C# word library, IronWord.
Instalacja IronWord
There are two ways to install IronWord.
1. Installing via NuGet Package Manager
To install it through the NuGet Package Manager, click on tools and then Manage NuGet Packages for Solution. We then search for IronWord in the search bar and install **IronWord**.

2. Installing via NuGet Package Manager Console
An alternative method is to install it via the NuGet Package Manager Console. To do so, run the following command in the console:
Install-Package IronWord
Klucz licencyjny
Please note that IronWord doesn't work without a licensing key; you can obtain one here as part of a free trial.
After obtaining a trial key, ensure this variable is set in your project.
// 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
After installing the prerequisites, we will demonstrate the simplicity of reading a Microsoft Word document using IronWord in the following code.
First, we import the necessary namespaces. Using IronWord, we create a new document and add sample text. We then access the paragraphs and text using the WordDocument object to print out the text within the Word document.
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
Let's explore the methods and parameters to read word files from the above code.
-
We first create a Text object and assign the string "Sample text" to it.
-
We then instantiate a Paragraph object and add the "textRunExample" to it.
-
We also instantiate a WordDocument object, name it
WordDocument doc,and pass theparagraphExampleto it to create a new Word document containing the paragraph. -
The code saves the Word document with the file name "document.docx" for later use.
-
To access the paragraphs in the Word document we just created, we access the "Paragraphs" property of the WordDocument object. The "Paragraphs" property is a list. Hence, we call a foreach loop to iterate through it.
-
To obtain the text within the paragraph, we access the "Texts" property of Paragraphs. This also returns a list of Text.
- Finally, we assign the Text to a string variable named "content" and print it out to the console.
Console output

Reading an existing Word document in C
In the previous example, we programmatically created a new Word document and read its content. We can follow similar steps to read an existing Word document by making a few code changes.
Input Document

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
The main difference between the two examples is the parameter passed into the WordDocument object. Instead of creating a new document, we load an existing Word file into it. The rest is the same as the other example.
Console output

Wnioski

Throughout the examples, we demonstrated how straightforward it is to use the IronWord library to manipulate and read Word documents programmatically in C#. The flexibility and scałability of the IronWord library make it a valuable tool that allows developers to use IronWord in practical, real-life examples, such as filling templates, generating reports, and batch-processing documents. Understanding how Word integrates with applications is valuable as it provides developers with more solutions to their problems.
Furthermore, developers can test IronWord's extensive features for a period of time before purchasing, as it offers a free trial license. 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. Oferujemy również różne samouczki i szereg przykładów kodu, które pomogą Ci rozpocząć pracę z IronWord.
Po przetestowaniu różnych funkcji IronWord przy użyciu Licencji Trial możesz kupić naszą licencję deweloperską Lite, której cena zaczyna się od 599 USD, a kolejne poziomy to Lite i Professional. Więcej informacji można znaleźć na naszej stronie poświęconej licencjom.
Często Zadawane Pytania
Jak mogę odczytać dokument WORDa za pomocą języka C#?
Możesz użyć IronWord do odczytania dokumentu Worda w języku C#. Wystarczy załadować dokument za pomocą klasy WordDocument, a następnie iterować przez akapity i fragmenty tekstu, aby uzyskać dostęp do treści tekstowej i wyświetlić ją.
Jaka jest niezawodna biblioteka C# do odczytu dokumentów WORD?
IronWord to niezawodna biblioteka C# przeznaczona do odczytu i manipulacji dokumentami Word. Zapewnia prosty interfejs API, który ułatwia integrację funkcji dokumentów Word z aplikacjami.
Czy muszę mieć zainstalowany pakiet Microsoft Office, aby otwierać dokumenty WORD w języku C#?
Nie, IronWord nie wymaga zainstalowania pakietu Microsoft Office. Działa niezależnie, umożliwiając edycję dokumentów WORD bez konieczności posiadania licencjonowanej wersji pakietu Office.
Jak zainstalować bibliotekę C# do odczytu dokumentów WORD w Visual Studio?
Możesz zainstalować IronWord za pomocą menedżera pakietów NuGet w Visual Studio, wyszukując „IronWord” i wybierając „Zainstaluj”, lub korzystając z konsoli menedżera pakietów NuGet za pomocą polecenia Install-Package IronWord.
Jakie platformy obsługuje IronWord do edycji dokumentów WORD?
IronWord obsługuje różne platformy, w tym .NET Core (8, 7, 6, 5 i 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) oraz Azure, i jest kompatybilny z systemami Windows, Linux, macOS i Android.
Czy mogę modyfikować istniejące dokumenty WORDa za pomocą biblioteki C#?
Tak, IronWord umożliwia programowe odczytywanie i modyfikowanie zarówno nowych, jak i istniejących dokumentów WORD, zapewniając pełną kontrolę nad treścią i strukturą dokumentu.
Czy dostępna jest bezpłatna wersja próbna IronWord?
Tak, IronWord oferuje bezpłatną licencję probną. Programiści mogą skorzystać z tej wersji próbnej, aby zapoznać się z jej funkcjami i ocenić jej przydatność do swoich projektów przed zakupem pełnej licencji.
Jak mogę konwertować dokumenty WORDa na inne formaty za pomocą języka C#?
Możesz użyć IronWord do konwersji dokumentów WORDa do różnych formatów, wykorzystując jego API do eksportowania dokumentów do formatów takich jak PDF, HTML i innych, chociaż szczegóły konwersji mogą się różnić.
Jakie są typowe zastosowania IronWord w aplikacjach napisanych w języku C#?
IronWord jest powszechnie używany do zadań takich jak wypełnianie szablonów, generowanie raportów, przetwarzanie dokumentów w trybie wsadowym oraz integracja funkcji dokumentów WORDa z aplikacjami .NET.
Jakie opcje wsparcia są dostępne dla użytkowników IronWord?
IronWord zapewnia wsparcie techniczne przez 5 dni w tygodniu, a także obszerną dokumentację, samouczki i przykłady kodu, aby pomóc programistom w efektywnym wykorzystaniu biblioteki IronWord.




