Comment manipuler un document Word en utilisant C#

Comment manipuler un document Word à l'aide de C

1. Créez un tout nouveau projet Visual Studio.
2. Configurez la bibliothèque nécessaire pour lire les documents Word.
3. Pour manipuler un document Word, chargez un fichier existant ou créez un nouveau fichier.
4. Modifiez les données du document et analysez le fichier.
5. Supprimez tous les objets créés.

Qu'est-ce que Microsoft Interop ?

Les programmes écrits en C# ou VB.NET peuvent créer ou ouvrir des documents Word (DOC, DOCX et RTF) grâce à l'interopérabilité Office pour Microsoft Word. Cependant, son utilisation dans des projets présente de nombreux inconvénients.

Nous aborderons dans cet article les problèmes fréquents que vous pourriez rencontrer lors de l'utilisation de Microsoft Office Interop (automatisation Word) depuis C# ou VB.NET.

Par exemple :

• Chaque poste client requis pour l'automatisation des tâches de traitement de texte doit être équipé d'une licence Microsoft Word.
• Sur chaque PC client, la même version de Microsoft Word doit être installée.
• Word utilise quelques mégaoctets de RAM pour charger différents fichiers et DLL en arrière-plan lorsque l'automatisation est utilisée.
• L'API Microsoft Word est accessible via un objet COM. Des problèmes peuvent survenir lors de l'appel d'un objet COM à partir de code managé, tels que des conversions de type, la nécessité d'un wrapper COM et une mauvaise intégration avec le framework .NET.

Créer un nouveau projet dans Visual Studio

Install-Package Microsoft.Office.Interop.Word

Manipuler des documents Word existants à l'aide d'Interop

Pour utiliser Microsoft Word, vous devez d'abord créer une instance de Microsoft.Office.Interop.Word.Application . Dans ce cas, la communication se ferait par le biais de documents Word. L'étape suivante consiste à créer une nouvelle instance de document Word en utilisant la propriété Documents de l'instance Microsoft.Office.Interop.Word.Application que nous venons de créer. Comme le montre l'extrait de code C# ci-dessous, cela nous permet de manipuler des documents Word par programmation :

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

Imports System
Imports Microsoft.Office.Interop.Word

Friend Class Program
	Shared Sub Main()
		Try
			' Create a new instance of Word Application
			Dim WordApp = New Microsoft.Office.Interop.Word.Application()
			' Open an existing document
			Dim WordDoc = WordApp.Documents.Open("d:/Demo.docx")
			' Edit the content of the first paragraph
			WordDoc.Paragraphs(1).Range.Text = "New text here..."
			' Save the edited document
			WordDoc.SaveAs("d:/NewDemo.docx")
			' Close the document
			WordDoc.Close()
			' Quit the Word application
			WordApp.Quit()
		Catch ex As Exception
			Console.WriteLine(ex.ToString())
		End Try
	End Sub
End Class

Dans le code ci-dessus, nous pouvons modifier le document Word en C#. Nous créons d'abord une instance de l'application Word à l'aide d'Interop. La méthode Open est ensuite utilisée pour ouvrir un fichier Word existant et le convertir en un objet document. Nous pouvons alors accéder aux différentes propriétés et méthodes disponibles pour interagir avec le document. Dans cet exemple, nous mettons à jour le texte du premier paragraphe, en utilisant la collection Paragraphs et un index pour spécifier quel paragraphe modifier. Enfin, les modifications sont enregistrées avec SaveAs , et le document et l'application sont correctement fermés.

Bibliothèque IronXL : alternative à Interop

IronXL est une alternative à Microsoft Interop qui peut être utilisée dans les programmes .NET pour gérer les fichiers Excel. Alors que Microsoft Interop nécessite d'interagir avec Excel via les assemblys Interop, IronXL offre une méthode plus simple, efficace et puissante pour manipuler par programmation les fichiers Excel dans des contextes .NET.

L'utilisation d'IronXL au lieu de Microsoft Interop présente plusieurs avantages, tels que :

• Performances et efficacité des ressources : Comparé à Microsoft Interop, qui dépend de l'installation de l'application Excel sur l'ordinateur, IronXL offre de meilleures performances et utilise moins de ressources car il n'est pas dépendant de l'application Excel.
• Facilité d'utilisation et simplicité : IronXL fournit une API plus facile à utiliser qui simplifie la lecture, l'écriture et la manipulation des fichiers Excel sans les complications liées à Microsoft Interop.
• Compatibilité et dépendances : IronXL élimine les dépendances et les problèmes de compatibilité pouvant survenir avec différentes versions d'Excel ou d'Office en ne nécessitant pas l'installation de Microsoft Excel sur l'ordinateur.
• Indépendance de la plateforme : Contrairement à Microsoft Interop, qui peut être plus étroitement associé à des versions particulières de Microsoft Office, IronXL offre une plus grande flexibilité et une facilité de déploiement sur divers environnements et plateformes.

Pour les développeurs .NET qui doivent manipuler des fichiers Excel par programmation, IronXL est souvent une meilleure option en raison de sa facilité d'utilisation, de sa rapidité et de sa moindre dépendance aux installations de logiciels tiers. Le choix entre IronXL et Microsoft Interop pourrait toutefois être influencé par les spécificités du projet, l'infrastructure existante et le niveau d'expertise de l'utilisateur avec chaque bibliothèque.

Lorsque vous devez choisir entre ces options, gardez toujours à l'esprit les exigences de votre application. Cliquez sur ce lien pour en savoir plus sur la bibliothèque IronXL.

Installation de la bibliothèque IronXL

La bibliothèque IronXL étant nécessaire pour le prochain correctif, veuillez l'installer. Pour terminer, ouvrez la console du gestionnaire de packages NuGet et saisissez la commande suivante :

Install-Package IronWord

Comment manipuler un document Word avec C# : Figure 6 - Installation d'IronXL à l'aide de la commande console

Vous pouvez également rechercher le package " IronXL " via le gestionnaire de packages NuGet. Dans la liste des packages NuGet associés à IronXL, vous pouvez sélectionner celui que vous souhaitez télécharger.

Comment manipuler un document Word avec C# : Figure 7 - Installation du package IronXL.Excel par navigation

Modification de documents Excel avec IronXL

Les données peuvent être exportées aux formats XLSX ou XLS en quelques lignes de code seulement. L'exemple de code source suivant montre comment exporter des données d'un fichier Excel vers un tableau simple :

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

Imports IronXL

Friend Class Program
	Shared Sub Main()
		' Load an existing Excel file
		Dim workbook = WorkBook.Load("Demo file.xlsx")
		' Access the first sheet or the sheet by name
		Dim ws = workbook.GetWorkSheet("Sheet1")
		' Read a value from a cell and output it to the console
		Dim address_val As String = ws("A1").ToString()
		Console.WriteLine(address_val)
		' Modify a cell's value
		ws("A2").Value = "Hello World"
		' Save the workbook to different formats
		workbook.SaveAs("export.xlsx")
		workbook.SaveAs("export.xls")
		workbook.WorkSheets(0).SaveAs("export.xls")
	End Sub
End Class

L'exemple précédent charge un fichier Excel existant en appelant la fonction Load , qui prend en argument le chemin d'accès et le nom du fichier. L'importation du fichier dans l'objet WorkBook est maintenant terminée. Les feuilles de calcul Excel sont ensuite chargées à l'aide de GetWorkSheet , qui nous permet de charger la feuille de calcul en utilisant son nom. L'adresse Excel a ensuite été utilisée pour lire la valeur. Pour en savoir plus sur la lecture des fichiers Excel, cliquez ici .

Nous pouvons modifier les valeurs de la feuille Excel en utilisant la même adresse Excel. Le document Excel peut être enregistré au format XLSX ou XLS en utilisant la fonction SaveAs proposée par l'objet WorkBook . Ce procédé permet d'enregistrer l'intégralité du fichier au format choisi.

Comment manipuler un document Word avec C# : Figure 8 - Sortie console

De plus, nous pouvons sélectionner une feuille de calcul Excel spécifique en utilisant sa valeur d'index ou en la référençant par son nom. Ensuite, nous pouvons exporter les données de la feuille de calcul Excel vers un autre fichier en utilisant l'option SaveAs . Cliquez sur ce lien pour en savoir plus sur la mise en forme et l'exportation des fichiers Excel.

Conclusion

IronXL est l'un des modules complémentaires les plus populaires pour Excel. Il ne dépend d'aucune bibliothèque externe supplémentaire. Il n'est pas nécessaire d'installer Microsoft Excel car il est autonome. Il fonctionne via une multitude de canaux. Cela contraste avec la bibliothèque Interop qui doit analyser le fichier à l'aide de bibliothèques supplémentaires pour modifier les documents Word.

IronXL est une solution complète pour tout processus de programmation utilisant des documents Microsoft Excel. Calculs, tri de chaînes de caractères ou de nombres, élagage, ajout, recherche et remplacement, fusion et défusion, et stockage de fichiers ne sont que quelques exemples des nombreuses opérations disponibles. Non seulement les données des feuilles de calcul peuvent être validées, mais vous pouvez également créer de nouvelles formes de données cellulaires. Il facilite la lecture et l'écriture de fichiers ainsi que la gestion des données Excel.

Lors de sa première sortie, IronXL coûtait $799 . Les clients peuvent également opter pour un abonnement annuel afin de recevoir les mises à jour logicielles et l'assistance. Moyennant un supplément, IronXL assure la protection contre la redistribution non autorisée. Rendez-vous sur la page des licences IronXL. Pour en savoir plus sur les produits Iron Software, cliquez ici .