Passer au contenu du pied de page
UTILISATION D'IRONWORD

Comment lire un fichier Word en utilisant C#

De nos jours, les documents Microsoft Word sont synonymes de travail de bureau et de communication professionnelle et personnelle. Par conséquent, la manipulation programmatique des documents Word est essentielle pour les développeurs qui cherchent à automatiser les tâches à afficher aux utilisateurs dans leurs applications. Bien qu'il existe de nombreuses bibliothèques disponibles, toutes ne sont pas aussi performantes que d'autres. Cependant, parmi ces concurrents, IronWord se distingue nettement. IronWord est une bibliothèque C# Word DOCX fiable et robuste, facile à utiliser et à comprendre, qui simplifie le travail avec les documents Word.

Cet article expliquera comment utiliser rapidement IronWord pour lire des documents Word à l'aide de courts exemples.

Comment lire un fichier Word en utilisant C

  1. Créez une application console dans Visual Studio

  2. Installez la bibliothèque IronWord C# DOCX

  3. Créez un nouveau document Word à l'aide de la classe WordDocument.

  4. Ajouter du texte au document Word

  5. Parcourez chaque paragraphe à l'aide de la classe Paragraph.

  6. Afficher le contenu

IronWord : la bibliothèque DOCX C

IronWord : la bibliothèque DOCX C#

IronWord est une bibliothèque flexible et évolutive dotée d'une API simple et facile à utiliser qui élimine les difficultés d'intégration des documents Word dans les applications. Que vous souhaitiez ajouter et intégrer un simple document Word à votre application ou créer des tableaux et des rapports complexes à afficher aux utilisateurs, IronWord a tout ce qu'il vous faut.

Voici ses caractéristiques les plus remarquables :

  1. Manipulation de documents : IronWord permet aux développeurs de manipuler facilement les documents Word. Que les utilisateurs souhaitent insérer des paragraphes de texte ou des structures plus complexes telles que des tableaux et des images, IronWord peut tout faire.

  2. Compatibilité et prise en charge multiplateformes : IronWord est conçu pour être flexible et prend en charge les développeurs sur plusieurs plateformes. Il prend en charge diverses versions de .NET Core (8, 7, 6, 5 et 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) et même Azure. De plus, les développeurs peuvent utiliser IronWord sur différentes plateformes et systèmes, notamment Windows, Linux, macOS et Android. Il couvre les plateformes les plus courantes et permet aux développeurs de créer rapidement des applications multiplateformes.

  3. Indépendance vis-à-vis de Microsoft Office : L'intégration de documents Word dans des applications .NET pose souvent problème car des bibliothèques populaires comme Interop nécessitent une licence Microsoft Office. IronWord, quant à lui, s'affranchit de cette contrainte. Les développeurs peuvent exploiter pleinement la puissance des documents Word sans être limités par la licence et l'installation de Microsoft Word.

  4. Options de mise en forme : IronWord offre une prise en charge étendue de la mise en forme et du style, permettant aux développeurs de rendre le document unique. Les développeurs peuvent appliquer des polices à leur texte, des couleurs , des alignements et d'autres mises en forme complexes, telles que des styles de tableau .

  5. Facilité d'utilisation et assistance étendue : Outre une API facile à comprendre et des appels de méthode simples, IronWord fournit également des références d'API d'extension et des exemples de code pour aider les développeurs à déterminer la manière optimale d'utiliser IronWord.

Création d'un nouveau projet console dans Visual Studio

Avant de nous plonger dans l'exemple, commençons par créer un projet console vierge dans Visual Studio .

! Cliquez sur application console lors de la création d'un nouveau projet

Nous attribuons ensuite un nom et un emplacement d'enregistrement au projet.

! Spécifiez le nom et le chemin d'accès du projet.

Ensuite, sélectionnez le framework .NET que vous allez utiliser. Dans cet exemple, j'utiliserai .NET 8.0.

Sélectionnez le framework .NET souhaité et cliquez sur Créer.

Après avoir créé et configuré le nouveau projet de console, installons notre bibliothèque de traitement de texte C#, IronWord .

Installation d'IronWord

Il existe deux façons d'installer IronWord.

1. Installation via le gestionnaire de packages NuGet

Pour l'installer via le gestionnaire de packages NuGet, cliquez sur Outils puis Manage NuGet Packages for Solution . Nous recherchons ensuite IronWord dans la barre de recherche et installons **IronWord** .

Installez IronWord en utilisant la fonction " Gérer les packages NuGet pour la solution " : recherchez " IronWord " dans la barre de recherche du Gestionnaire de packages NuGet, puis sélectionnez le projet et cliquez sur le bouton " Installer ".

2. Installation via la console du gestionnaire de packages NuGet

Une autre méthode consiste à l'installer via la console du gestionnaire de packages NuGet. Pour ce faire, exécutez la commande suivante dans la console :

Install-Package IronWord

Clé de licence

Veuillez noter qu'IronWord ne fonctionne pas sans clé de licence ; Vous pouvez en obtenir un ici dans le cadre d'un essai gratuit .

Après avoir obtenu une clé d'essai, assurez-vous que cette variable est définie dans votre projet.

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

Lecture de documents Word en C

Après avoir installé les prérequis, nous allons démontrer la simplicité de la lecture d'un document Microsoft Word à l'aide d'IronWord dans le code suivant.

Tout d'abord, nous importons les espaces de noms nécessaires. À l'aide d'IronWord, nous créons un nouveau document et y ajoutons un texte d'exemple. Nous accédons ensuite aux paragraphes et au texte à l'aide de l'objet WordDocument pour imprimer le texte dans le document Word.

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

Explorons les méthodes et les paramètres permettant de lire les fichiers Word à partir du code ci-dessus.

  1. Nous créons d'abord un objet Text et nous lui assignons la chaîne " Texte d'exemple ".

  2. Nous instancions ensuite un objet Paragraph et y ajoutons le " textRunExample ".

  3. Nous instancions également un objet WordDocument , que nous nommons WordDocument doc, et nous lui passons le paragraphExample pour créer un nouveau document Word contenant le paragraphe.

  4. Le code enregistre le document Word sous le nom de fichier " document.docx " pour une utilisation ultérieure.

  5. Pour accéder aux paragraphes du document Word que nous venons de créer, nous accédons à la propriété " Paragraphes " de l'objet WordDocument . La propriété " Paragraphes " est une liste. Par conséquent, nous utilisons une boucle foreach pour la parcourir.

  6. Pour obtenir le texte contenu dans le paragraphe, nous accédons à la propriété " Textes " de Paragraphs . Cela renvoie également une liste de texte .

  7. Enfin, nous assignons le texte à une variable de type chaîne nommée " content " et l'affichons dans la console.

Sortie de la console

! Sortie console affichant le texte lu à partir du document Word.

Lecture d'un document Word existant en C

Dans l'exemple précédent, nous avons créé par programmation un nouveau document Word et lu son contenu. Nous pouvons suivre des étapes similaires pour lire un document Word existant en apportant quelques modifications au code.

Document d'entrée

Exemple de saisie : Document Word long

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

La principale différence entre les deux exemples réside dans le paramètre transmis à l'objet WordDocument . Au lieu de créer un nouveau document, nous y chargeons un fichier Word existant. Le reste est identique à l'autre exemple.

Sortie de la console

! Sortie de la console

Conclusion

Informations sur la licence IronWord

Tout au long des exemples, nous avons démontré à quel point il est simple d'utiliser la bibliothèque IronWord pour manipuler et lire des documents Word par programmation en C#. La flexibilité et l'évolutivité de la bibliothèque IronWord en font un outil précieux qui permet aux développeurs d'utiliser IronWord dans des exemples pratiques et concrets, tels que le remplissage de modèles, la génération de rapports et le traitement par lots de documents. Comprendre comment Word s'intègre aux applications est précieux car cela offre aux développeurs davantage de solutions à leurs problèmes.

De plus, les développeurs peuvent tester les nombreuses fonctionnalités d'IronWord pendant un certain temps avant de l'acheter, car il offre une licence d'essai gratuite . En plus de sa facilité d'utilisation, IronWord est également fourni avec une documentation complète et une assistance 24h/24 et 5j/7 pour les développeurs, ce qui atténue la frustration constante que ces derniers peuvent rencontrer en production. Nous proposons également divers tutoriels et une gamme d' exemples de code de référence pour vous aider à démarrer avec IronWord .

Après avoir testé différents aspects d' IronWord à l'aide d'une licence d'essai, vous pouvez acheter notre licence développeur Lite, dont le prix commence à 599 $ et varie de la version Lite à la version Professionnelle. Veuillez consulter notre page relative aux licences pour plus d'informations.

Questions Fréquemment Posées

Comment puis-je lire un document Word en utilisant C# ?

Vous pouvez utiliser IronWord pour lire un document Word en C#. Chargez simplement le document en utilisant la classe WordDocument, puis itérez à travers les paragraphes et les exécutions de texte pour accéder et afficher le contenu textuel.

Quelle est une bibliothèque C# fiable pour lire des documents Word ?

IronWord est une bibliothèque C# fiable conçue pour lire et manipuler des documents Word. Elle fournit une API simple qui simplifie l'intégration des fonctionnalités de document Word dans les applications.

Ai-je besoin d'avoir Microsoft Office installé pour lire des documents Word en C# ?

Non, IronWord ne nécessite pas que Microsoft Office soit installé. Il fonctionne de manière indépendante, vous permettant de manipuler des documents Word sans avoir besoin d'une version sous licence d'Office.

Comment puis-je installer une bibliothèque C# pour lire des documents Word dans Visual Studio ?

Vous pouvez installer IronWord via le gestionnaire de packages NuGet dans Visual Studio en recherchant 'IronWord' et en sélectionnant 'Installer', ou en utilisant la console du gestionnaire de packages NuGet avec la commande Install-Package IronWord.

Quelles plateformes sont supportées par IronWord pour la manipulation des documents Word ?

IronWord supporte une variété de plateformes, y compris .NET Core (8, 7, 6, 5, et 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+), et Azure, et est compatible avec Windows, Linux, macOS, et Android.

Puis-je manipuler des documents Word existants en utilisant une bibliothèque C# ?

Oui, IronWord vous permet de lire et de modifier à la fois de nouveaux et d'anciens documents Word par programmation, offrant un contrôle total sur le contenu et la structure du document.

Existe-t-il un essai gratuit disponible pour IronWord ?

Oui, IronWord offre une licence d'essai gratuite. Les développeurs peuvent utiliser cet essai pour explorer ses fonctionnalités et évaluer son adéquation pour leurs projets avant d'acheter une licence complète.

Comment puis-je convertir des documents Word en autres formats en utilisant C# ?

Vous pouvez utiliser IronWord pour convertir des documents Word en divers formats en utilisant son API pour exporter des documents dans des formats comme PDF, HTML, et plus encore, bien que les spécificités de la conversion puissent varier.

Quels sont certains cas d'utilisation courants pour IronWord dans les applications C# ?

IronWord est couramment utilisé pour des tâches telles que le remplissage de modèles, la génération de rapports, le traitement par lot de documents, et l'intégration des fonctionnalités de documents Word dans les applications .NET.

Quelles options de support sont disponibles pour les utilisateurs d'IronWord ?

IronWord fournit un support 24/5, ainsi qu'une documentation complète, des tutoriels et des exemples de code, pour assister les développeurs dans l'utilisation efficace de la bibliothèque.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite