UTILISATION D'IRONWORD

Comment lire un fichier Word à l'aide de C#

Regan Pun
Regan Pun
août 15, 2024
Partager:

À l'ère actuelle, les documents Microsoft Word sont synonymes de travail de bureau et de communication professionnelle et personnelle. Par conséquent, manipuler les documents Word de manière programmatique est essentiel pour les développeurs souhaitant automatiser des tâches afin de les afficher aux utilisateurs dans leurs applications. Bien qu'il existe de nombreuses bibliothèques disponibles, elles ne sont pas toutes aussi robustes les unes que les autres. Cependant, l'un des prétendants qui se démarque des autres est IronWord. IronWord est une bibliothèque DOCX Word C# fiable et robuste, facile à utiliser et à comprendre, qui simplifie le travail avec les documents Word.

Cet article explorera comment nous pouvons rapidement utiliser IronWord pour lire des documents Word avec de courts exemples.

Comment lire un fichier Word en utilisant C

  1. Créer une application console dans Visual Studio

  2. Installer la bibliothèque IronWord C# DOCX

  3. Créez un nouveau document Word en utilisant la classe WordDocument

  4. Ajouter du texte au document Word

  5. Parcourez chaque paragraphe en utilisant la classe Paragraph

  6. Afficher le contenu

IronWord : La bibliothèque DOCX pour C

IronWord : La bibliothèque DOCX pour C#

IronWord est une bibliothèque flexible et évolutive avec 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 texte à votre application ou créer des tableaux et des rapports complexes à afficher aux utilisateurs, IronWord a tout ce qu'il vous faut.

Voici ses fonctionnalités les plus remarquables.

  1. Manipulation de documents : IronWord permet aux développeurs de manipuler des documents Word avec facilité. 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. Prise en charge multiplateforme et compatibilité : IronWord est conçu pour être flexible et prend en charge les développeurs sur plusieurs plateformes. Il prend en charge divers .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, y compris mais sans s'y limiter 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 : Un problème courant lors de l'intégration de documents Word dans les applications .Net est que les bibliothèques populaires telles qu'Interop nécessitent une installation sous licence de Microsoft Office. Cependant, IronWord atténue ce problème en étant indépendant de cette restriction. Les développeurs peuvent pleinement exploiter la puissance des documents Word sans être limités par la licence et l'installation de Microsoft Word.

  4. Options de formatage : IronWord offre un support étendu pour le formatage et le stylisme, 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 support étendu : Avec une API facile à comprendre et des appels de méthodes simples, IronWord fournit également des références d'API d'extension et des exemples de code pour aider les développeurs à déterminer le moyen le plus optimal d'utiliser IronWord.

Créer un nouveau projet de console dans Visual Studio

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

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

Nous fournissons ensuite un nom et un emplacement de sauvegarde pour le projet.

Spécifiez le nom et le chemin d'emplacement pour le 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 console, installons notre bibliothèque de mots C#, IronWord.

Installation d'IronWord

Il y a 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 `Gérer les solutions NuGet.` Nous cherchons ensuite IronWord dans la barre de recherche et installons `IronWord.`

Installez IronWord en utilisant le gestionnaire de packages NuGet pour la solution en recherchant 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 méthode alternative 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
Install-Package IronWord
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord
$vbLabelText   $csharpLabel

Clé de licence

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

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";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Lecture de documents Word en C

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

Tout d'abord, nous importons l'espace de noms suivant. En utilisant IronWord, nous créons un nouveau document et ajoutons du texte exemple. Nous accédons ensuite aux paragraphes et au texte en utilisant l'objet `WordDocument` pour imprimer le texte à l'intérieur du document Word.

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

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

  1. Nous créons d'abord un objet Texte et nous lui attribuons 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, le nommons `WordDocument doc,` et lui transmettons 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é "Paragraphs" de l'objet WordDocument. La propriété « Paragraphs » est une liste. Par conséquent, nous utilisons une boucle foreach pour la parcourir.

  6. Pour obtenir le texte à l'intérieur du paragraphe, nous accédons à la propriété "Texts" des 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 console

Sortie de la console affichant le texte lu à partir du document Word doc.

Lecture d'un document Word existant en C

Dans l'exemple précédent, nous avons créé un nouveau document Word par programmation 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 d'entrée : Document Word long format

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

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

Sortie console

Sortie de la console

Conclusion

Informations sur la licence IronWord

Dans tous les exemples, nous avons démontré à quel point il est simple d'utiliser la bibliothèque IronWord pour manipuler et lire des documents Word de manière programmatique 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 réels, tels que remplir des modèles, générer des rapports et traiter des documents par lots. Comprendre comment Word s'intègre aux applications est précieux car cela permet aux développeurs de trouver plus de solutions à leurs problèmes.

De plus, les développeurs peuvent tester les fonctionnalités étendues d'IronWord pendant une période avant de l'acheter, car elle offre une version d'essai gratuite. En plus de sa facilité d'utilisation, IronWord est également fourni avec une documentation complète et un support 24/5 pour les développeurs, atténuant ainsi la frustration constante à laquelle les développeurs peuvent être confrontés en production. Nous proposons également divers tutoriels et une gamme de exemples de code comme référence pour vous aider à démarrer avec IronWord.

Après avoir testé divers aspects de IronWord en utilisant une licence d'essai, vous pouvez acheter notre licence développeur Lite qui commence à 599 $ et augmente de Lite à Professionnel. Veuillez consulter notre page de licences pour plus d'informations.

Regan Pun
Ingénieur logiciel
Regan est diplômé de l'université de Reading, où il a obtenu une licence en ingénierie électronique. Avant de rejoindre Iron Software, il s'était concentré sur une seule tâche. Ce qu'il apprécie le plus chez Iron Software, c'est la diversité des tâches qu'il peut accomplir, qu'il s'agisse d'apporter une valeur ajoutée aux ventes, à l'assistance technique, au développement de produits ou à la commercialisation. Il aime comprendre comment les développeurs utilisent la bibliothèque d'Iron Software et utiliser ces connaissances pour améliorer continuellement la documentation et développer les produits.
< PRÉCÉDENT
3 Bibliothèques Word C# (Liste mise à jour pour les développeurs)
SUIVANT >
Comment manipuler un document Word à l'aide de C#