USO DE IRONWORD

Cómo exportar un documento a Word en C#

Regan Pun
Regan Pun
6 de junio, 2024
Compartir:

Microsoft Word es una herramienta omnipresente para crear y editar documentos, muy utilizada en diversos sectores por sus versátiles funciones y su interfaz fácil de usar. En el desarrollo de software, a menudo nos encontramos con situaciones en las que necesitamos generar mediante programación documentos de Word, ya sea con fines informativos, de documentación o de presentación de datos.

En esta guía, exploraremos cómo crear una nueva aplicación de consola en C# y cómo exportar datos a documentos de MS Word en C# usando IronWord, una potente biblioteca para manipular documentos de Word programáticamente.

Cómo exportar un documento a Word en C#

  1. Cree un nuevo proyecto de C# Visual Studio.

  2. Instale la biblioteca C# Word para exportar datos a Word.

  3. Importar dependencias para la Biblioteca Word.

  4. Crear un nuevo documento de Word utilizando el método "new WordDocument(paragraph)".

  5. Guarde el nuevo documento de Word creado con la función "SaveAs()".

Crear una nueva aplicación de consola C&num

Para crear una nueva aplicación de consola C# en Visual Studio, siga estos pasos.

  1. Abra Visual Studio. En la pantalla de inicio, seleccione la opción "Crear un nuevo proyecto".

    Cómo Exportar un Documento a Word en C#: Figura 1 - Visual Studio

  2. Aparecerá una nueva ventana con las plantillas recientes y todas las plantillas disponibles. Seleccione la opción "Console App" y haga clic en Siguiente.

    Cómo Exportar un Documento a Word en C#: Figura 2 - Aplicación de Consola

  1. En la nueva ventana que aparece, escriba el nombre del proyecto y seleccione la ubicación. Haga clic en Siguiente y después de seleccionar la versión haga clic en Crear.

IronWord

IronWord es una biblioteca .NET que proporciona una práctica API para trabajar con documentos Word en C#. Permite a los desarrolladores crear documentos Word, modificar documentos Word existentes y exportar documentos Word sin problemas dentro de sus aplicaciones C#. Con IronWord, puede generar documentos de Word de forma dinámica a partir de datos de diversas fuentes, como bases de datos, API o entradas de usuario.

IronWord fomenta la creatividad y la expresión, proporcionando un espacio en el que las voces emergentes se mezclan con los autores experimentados. A través de su compromiso con la excelencia literaria y la diversidad, IronWord cultiva un rico tapiz de narrativas que resuenan en audiencias de todo el mundo, encendiendo la imaginación y suscitando conversaciones que perduran más allá de la página.

Instalar IronWord

Puedes instalar IronWord fácilmente utilizando NuGet Package Manager, sólo tienes que seguir estos pasos.

  1. En Visual Studio, abra la ventana del Gestor de paquetes NuGet y vaya a la pestaña Examinar.

  2. En la pestaña Examinar, escriba IronWord en la barra de búsqueda y pulse Intro.

    1. Aparecerá una lista de paquetes. Seleccione el último paquete y haga clic en Instalar.

    Cómo exportar un documento a Word en C#: Figura 3 - IronWord

    IronWord ya está instalado y listo para usar.

Exportar datos a un documento Word

Veamos un ejemplo práctico de cómo exportar datos a un documento de Word utilizando IronWord en C#. Considere el siguiente fragmento de código:

using IronWord;
using IronWord.Models;
System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();
// Create textRun
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new document object
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
using IronWord;
using IronWord.Models;
System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();
// Create textRun
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new document object
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models
System.Console.WriteLine("Enter the Text to export it to word document")
Dim userInput = System.Console.ReadLine()
' Create textRun
Dim textRun As New Text(userInput)
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
' Create a new document object
Dim doc As New WordDocument(paragraph)
' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

En este ejemplo, estamos creando un simple documento de Word que contiene un único párrafo con el texto del usuario. Desglosemos el código paso a paso:

  1. Importación de Bibliotecas Requeridas: Comenzamos importando los espacios de nombres necesarios de IronWord.

  2. Creación de contenido de texto: Creamos un objeto `Text` que representa el contenido de texto que queremos incluir en el documento de Word. En este caso, es el userInput.3. Creando un Párrafo: A continuación, creamos un objeto `Paragraph` y añadimos el objeto `Text` (textRun) a él como un elemento hijo. Un párrafo en Word suele contener una o más tiradas de texto.

  3. Creando un Documento de Word: Instanciamos un nuevo objeto `WordDocument`, pasando el párrafo que creamos como parámetro. Esto inicializa un nuevo documento de Word con el contenido especificado.5. Exportar el Documento: Finalmente, llamamos al método `SaveAs` en el objeto `WordDocument` para exportar el documento a un archivo .docx llamado "document.docx".

    Este ejemplo muestra el flujo de trabajo básico para exportar datos a un documento de Word utilizando IronWord. Sin embargo, es importante tener en cuenta que puede personalizar el contenido y la estructura del documento de Word existente según sus requisitos específicos. Por ejemplo, puede añadir varios párrafos, dar formato al texto, insertar tablas, imágenes, encabezados, pies de página y mucho más.

Captura de pantalla de la consola

Cómo exportar documentos a Word en C#: Figura 4 - Exportar datos en la salida de consola

Documento Word de salida

Cómo exportar un documento a Word en C#: Figura 5 - Crear salida de documento Word

Conclusión

En resumen, IronWord proporciona una solución potente y flexible para exportar datos a documentos Word en C#. Ya se trate de generar informes sencillos, documentos complejos o contenido dinámico, IronWord simplifica el proceso y permite a los desarrolladores crear documentos Word de alta calidad mediante programación. Al aprovechar sus funciones y capacidades, puede agilizar los flujos de trabajo de generación de documentos y ofrecer contenidos atractivos a sus usuarios.

Para aprender más técnicas para automatizar la generación de documentos de Microsoft Word, visite el siguiente enlace.

Regan Pun
Ingeniero de software
Regan se licenció en Ingeniería Electrónica por la Universidad de Reading. Antes de incorporarse a Iron Software, sus anteriores puestos de trabajo le obligaban a centrarse en tareas concretas; lo que más le gusta de Iron Software es la variedad de tareas que puede realizar, ya sea añadiendo valor a las ventas, el soporte técnico, el desarrollo de productos o el marketing. Le gusta entender cómo utilizan los desarrolladores la biblioteca de Iron Software y utilizar ese conocimiento para mejorar continuamente la documentación y desarrollar los productos.
< ANTERIOR
Cómo crear un documento Word a partir de una plantilla utilizando C#
SIGUIENTE >
.NET Word API (Cómo funciona para los desarrolladores)

¿Listo para empezar? Versión: 2025.4 acaba de salir

Ver licencias >