UTILISATION D'IRONWORD

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

Publié 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, un tel concurrent qui se distingue des autres est IronWord. 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 explorera comment nous pouvons rapidement utiliser IronWord pour lire des documents Word avec des exemples courts.

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. Bouclez chaque paragraphe à l'aide de la classe Paragraphe

  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 tracas liés à l'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 en toute simplicité. 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 Multi-Plateforme : IronWord est conçu pour être flexible et soutient les développeurs sur plusieurs plateformes. Il prend en charge divers .NET Core (8, 7, 6, 5 et 3.1+), Standard .NET (2.0+), Framework .NET (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 de Microsoft Office : Un problème courant lors de l'intégration de documents Word dans des applications .Net est que les bibliothèques populaires comme 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 mise en forme : IronWord offre un support étendu pour la mise en forme et le style, permettant aux développeurs de rendre le document unique. Les développeurs peuvent appliquer polices à leur texte, couleurs, alignements, et autres formats complexes, tels que styles de table.

  5. Facilité d'utilisation et support étendu : En plus d'une API facile à comprendre et d'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 la plus optimale 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 vierge dans Visual Studio.

Cliquez sur l'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'accès 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 de 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 sur `Gérer les solutions NuGet.` Nous recherchons ensuite IronWord dans la barre de recherche et installons `IronWord.`

Installez IronWord en utilisant la Gestion des packages NuGet pour la solution en cherchant 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
VB   C#

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";
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Lecture de documents Word en C

Après avoir installé les prérequis, nous démontrerons la simplicité de la 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 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
VB   C#

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

  1. Nous commençons par créer un objet Text et lui attribuons la chaîne de caractères "Sample Text".

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

  3. Nous instancons également un objet WordDocument, le nommons `WordDocument doc,` et lui passons `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 Paragraphes. 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 à la console.

Sortie console

Sortie console affichant le texte lu depuis le document Word doc.

Lire 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

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#

La principale différence entre les deux exemples est le paramètre passé dans 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 de licence pour IronWord

Tout au long des exemples, nous avons démontré à quel point il est simple d'utiliser le IronWord Bibliothèque 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 permettant aux développeurs d'utiliser IronWord dans des exemples pratiques et réels, 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 permet aux développeurs de trouver plus de solutions à leurs problèmes.

De plus, les développeurs peuvent tester les fonctionnalités étendues de IronWord pendant une période de temps avant de l'acheter, car il offre un essai gratuit licence. En plus de la facilité d'utilisation, IronWord est également accompagné d'une documentation complète. documentation et 24/5 support pour les développeurs, atténuant la frustration constante que les développeurs pourraient rencontrer en production. Nous proposons également diverses tutorials et une gamme de exemples de code pour référence afin de vous aider à commencer avec IronWord.

Après avoir testé divers aspects de IronWord En utilisant une licence d'essai, vous pouvez acheter notre licence de développeur Lite à partir de 599 $ et allant de Lite à Professional. Veuillez vous référer à notre licence pour plus d'informations.

< PRÉCÉDENT
3 bibliothèques de mots en C# (liste mise à jour pour les développeurs)
SUIVANT >
Comment manipuler un document Word à l'aide de C#