Passer au contenu du pied de page
UTILISATION D'IRONWORD

Comment créer des documents Word par programmation en VB .NET

Microsoft Word files, commonly known as DOCX files, are integral to document creation and communication in various industries. The ability to programmatically generate and manipulate Word documents is crucial for developers in Visual Basic.

In this article, we'll explore the importance of creating Microsoft Word files in C# applications and introduce the IronWord library as a powerful tool to generate Word Documents programmatically.

How to Create Word Document Programmatically in VB .NET

  1. Create a Visual Basic project in Visual Studio
  2. Install the IronWord Library from the NuGet Package Manager
  3. Create a TextRun and Paragraph
  4. Create a WordDocument ClassObject
  5. Add TextRun and Paragraph to WordDocument Object
  6. Export as a DOCX file using the SaveAs method

IronWord Library

IronWord is a feature-rich C# DOCX library developed by IronSoftware. It empowers developers to build, edit, and export Word documents without needing Microsoft Office or Word Interop. Supporting a range of .NET versions, IronWord provides a versatile solution for working with Word files in diverse project types and environments.

How to Create Word Document Programmatically in VB .NET: Figure 1 - IronWord webpage

Key Features:

IronWord offers a comprehensive set of features, making it a go-to library for Word document manipulation in C#. Some key features include:

  • Cross-Platform Support: Designed for C#, F#, and VB.NET, IronWord runs on various .NET versions, including 8, 7, 6, 5, Core, Standard, or Framework. It also caters to web, mobile, desktop, and console applications.

  • Document Structure Manipulation: IronWord allows developers to read and edit Word documents, extract text and images, customize page setup, and add paragraphs, text runs, images, shapes, and tables.

  • Styling and Formatting: The library supports styling options such as font family and size, color, bold, italic, underline, superscript, subscript, alignments, background color, and bullet/numbering lists.

  • Cross-Platform Compatibility: IronWord seamlessly works across different operating systems, including Windows, Linux, macOS, iOS, and Android.

Steps to Create a C# Console Project in Visual Studio

  1. Open Visual Studio.
  2. Create a new C# Console .NET Application.
  3. Name your project and choose a location.

How to Create Word Document Programmatically in VB .NET: Figure 2 - Configuring the project name and file path

  1. From Additional Information, select the latest version of the .NET Framework. IronWord supports the latest 8.0 .NET Core Framework.
  2. Click "Create" to generate the project.

Installing IronWord

To incorporate IronWord into your project to create a simple Word document, follow these steps:

Using the NuGet Package Manager

  1. Right-click on your project in Solution Explorer.
  2. Select "Manage NuGet Packages for Solution."
  3. Search for "IronWord" in the NuGet Package Manager browse tab.

How to Create Word Document Programmatically in VB .NET: Figure 3 - Installing IronWord in the NuGet package manager

  1. Click "Install" to add the IronWord library to your project.

Using Package Manager Console

Run the following command in the Package Manager Console:

Install-Package IronWord

Creating a Word Document in VB.NET

Let's go through a simple example to demonstrate how to create a Word document using IronWord in VB.NET:

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a text run containing the desired content
        Dim textRun As New TextRun("Sample text")

        ' Create a paragraph and add the text run to it
        Dim paragraph As New Paragraph()
        paragraph.AddTextRun(textRun)

        ' Create a new Word document containing the paragraph
        Dim document As New WordDocument(paragraph)

        ' Export the document as a DOCX file with the name "document.docx"
        document.SaveAs("document.docx")
    End Sub
End Module
Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a text run containing the desired content
        Dim textRun As New TextRun("Sample text")

        ' Create a paragraph and add the text run to it
        Dim paragraph As New Paragraph()
        paragraph.AddTextRun(textRun)

        ' Create a new Word document containing the paragraph
        Dim document As New WordDocument(paragraph)

        ' Export the document as a DOCX file with the name "document.docx"
        document.SaveAs("document.docx")
    End Sub
End Module
VB .NET

Code Explanation

Let's break down the key components of this VB.NET code for creating a Word Document:

Importing the IronWord Namespace:

Imports IronWord
Imports IronWord.Models
Imports IronWord
Imports IronWord.Models
VB .NET

These lines import the necessary namespaces from the IronWord library to use the classes and Word document model in your VB.NET code.

Creating a TextRun and Paragraph:

Dim textRun As New TextRun("Sample text")
Dim paragraph As New Paragraph()
paragraph.AddTextRun(textRun)
Dim textRun As New TextRun("Sample text")
Dim paragraph As New Paragraph()
paragraph.AddTextRun(textRun)
VB .NET

Here, a TextRun is created with the content "Sample text," and a Paragraph is created to hold the TextRun. This sets up the document with the content structure of the Word document.

Creating a Word Document:

The following code creates a new document object and adds a text paragraph to it:

Dim document As New WordDocument(paragraph)
Dim document As New WordDocument(paragraph)
VB .NET

An instance of the WordDocument class is created, and the Paragraph is passed to its constructor. This initializes the Word document with the specified content.

Exporting the Document:

document.SaveAs("document.docx")
document.SaveAs("document.docx")
VB .NET

Finally, the SaveAs method is used to export the Word document as a DOCX file with the filename "document.docx."

Output:

Upon running the program, a Word File named "document.docx" will be generated in the project directory. Open this document to view the added content.

How to Create Word Document Programmatically in VB .NET: Figure 4 - Outputted PDF document from the previous code

IronWord provides simplicity and allows one to edit and manipulate specific paragraphs. To get more information on the methods involved in the document class, please visit this code examples page.

Conclusion

In this article, we explored the importance of creating Microsoft Word files in C# applications and introduced the IronWord library as a powerful tool for achieving this task. With its rich feature set, cross-platform support, and ease of integration into Visual Studio projects, IronWord simplifies the process of handling Word documents programmatically. Developers can leverage IronWord to enhance document processing capabilities and streamline creating and manipulating Word files in their C# applications.

For more detailed information about IronWord VB.NET and its capabilities, please visit its documentation page on IronWord's official website.

IronWord is free for development purposes and can be licensed to test out its complete functionality in commercial mode before deciding. Download the library from here and give it a try.

In this article, we explored the importance of creating Microsoft Word files in C# applications and introduced the IronWord library as a powerful tool for achieving this task. With its rich feature set, cross-platform support, and ease of integration into Visual Studio projects, IronWord simplifies the process of handling Word documents programmatically. Developers can leverage IronWord to enhance document processing capabilities and streamline creating and manipulating Word files in their C# applications.

Questions Fréquemment Posées

Comment puis-je créer un document Word de manière programmatique en utilisant VB.NET ?

Pour créer un document Word de manière programmatique en utilisant VB.NET, configurez un projet Visual Basic dans Visual Studio, installez la bibliothèque IronWord à partir du Gestionnaire de Packages NuGet, créez des objets TextRun et Paragraph, puis utilisez la classe WordDocument pour exporter le document en tant que fichier DOCX en utilisant la méthode SaveAs.

Puis-je manipuler des documents Word sans Microsoft Office en utilisant cette bibliothèque ?

Oui, vous pouvez manipuler des documents Word sans Microsoft Office en utilisant la bibliothèque IronWord, qui fonctionne indépendamment de Microsoft Office ou Word Interop.

Quels sont les avantages d'utiliser cette bibliothèque pour le traitement des documents Word ?

IronWord offre des avantages tels que le support multiplateforme, la manipulation de la structure du document, les options de style et de formatage, et la compatibilité avec diverses versions .NET et systèmes d'exploitation.

Comment installer la bibliothèque pour la création de documents Word en utilisant le gestionnaire de packages NuGet ?

Vous pouvez installer la bibliothèque IronWord pour la création de documents Word en utilisant le gestionnaire de packages NuGet dans Visual Studio et en exécutant la commande : Install-Package IronWord.

La bibliothèque est-elle adaptée à un usage commercial ?

IronWord est gratuit pour des fins de développement et offre la possibilité de tester toutes ses fonctionnalités en mode commercial avant de prendre une décision de licence.

Quels types d'applications peuvent utiliser cette bibliothèque de documents Word ?

Les applications qui ont besoin de générer et de manipuler des documents Word de manière programmatique, comme les applications web, mobiles, de bureau et console, peuvent utiliser la bibliothèque IronWord.

Où puis-je trouver une documentation détaillée pour cette bibliothèque de documents Word ?

Une documentation détaillée et des informations supplémentaires sur les fonctionnalités d'IronWord sont disponibles sur la page de documentation officielle d'IronWord fournie par Iron Software.

Pourquoi la génération programmatique de documents Word est-elle importante ?

La génération programmatique de documents Word est importante pour automatiser la création et la manipulation de documents, ce qui améliore la productivité et l'efficacité dans diverses applications et industries.

Quelles sont les étapes essentielles pour configurer un projet de document Word dans Visual Studio ?

Les étapes essentielles comprennent la création d'un projet Visual Basic, l'installation d'IronWord via le gestionnaire de packages NuGet et l'intégration des objets TextRun et Paragraph dans un WordDocument pour l'exportation en tant que fichier DOCX.

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