USO DE IRONWORD

Cómo crear un archivo DOCX en C#

Publicado en 3 de abril, 2024
Compartir:

Introducción

Muchas aplicaciones del entorno digital actual requieren la capacidad de generar y modificar documentos automáticamente. La capacidad de crear y trabajar con archivos DOCX es útil tanto si está creando un sistema de informes a nivel empresarial, un sistema de gestión de documentos o simplemente automatizando actividades repetitivas. En este tutorial, nos sumergiremos en el mundo de la generación de documentos en C# y examinaremos las sólidas bibliotecas y métodos de programación que pueden utilizarse en C# para crear archivos DOCX.

Cómo crear un archivo DOCX en C#

  1. Instale el paquete NuGet IronWord.

  2. Tome los espacios de nombres necesarios e impórtelos desde IronWord.

  3. Para generar archivos de documento, añada un nuevo TextRun.

  4. Haga un nuevo Cuerpo y Documento.

  5. Llenar el cuerpo de contenido (párrafos, tablas, etc.).

  6. Utilizando WordDocument, crea un nuevo WordDocument.

  7. Asignando el objeto Document a la propiedad TextRun, Paragraph Document se guardarán las modificaciones.

Conozca el formato DOCX

Antes de profundizar en la codificación, aclaremos qué es un archivo DOCX. Microsoft Word y otros programas de tratamiento de textos guardan los documentos en formato DOCX. Se basa en el formato XML comprimido en ZIP [Estándar Office Open XML (OOXML)](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.). Esto permite utilizar API de Microsoft y otros desarrolladores para manipularlo mediante programación de forma relativamente sencilla.

IronWord

Iron Software creó la biblioteca de documentos de Word conocida como IronWord. Cuando se trata de ofrecer sólidas capacidades para la manipulación de documentos Word en aplicaciones .NET. IronWord brilla, para ayudar a los desarrolladores .NET C# a incluir la capacidad de crear, leer y modificar documentos Word y DOCX en sus programas, IronWord es una robusta biblioteca de documentos Word.

Características de IronWord

  • Cree y edite DOC y DOCX: IronWord elimina el requisito de Office Interop o la instalación de Microsoft Word al permitirle crear y editar documentos de Word directamente en sus proyectos .NET.
  • Abrir, editar un documento existente y guardar un archivo Word y Docx: La estructura del documento Word es personalizable, incluida la configuración de las páginas. (color de fondo, márgenes, tamaño de papel y orientación).
  • Incluya palabras e imágenes: Con la sencilla API, puedes añadir rápidamente texto y gráficos a tus documentos de Word.
  • Compatibilidad multiplataforma: IronWord es compatible con .NET 8, 7, 6, Core, Standard o Framework, y está construido para C#, F# y VB.NET. Funciona en varios entornos, como Docker, iOS, Android, Windows y Linux.
  • En todo el mundo, millones de ingenieros confían en nosotros: IronWord es un componente de Iron Suite, que consta de nueve productos de documentos ofimáticos .NET API. Desarrolladores de todo el mundo lo utilizan para crear, visualizar y modificar documentos Word.

    Para más información sobre IronWord aquí.

Creación de un nuevo proyecto en Visual Studio

Para iniciar la aplicación de Visual Studio, utilice el menú Archivo y elija Archivo. Haga clic en "Nuevo proyecto" y, a continuación, elija "Aplicación de consola".

Cómo crear un archivo DOCX en C#: Figura 1 - Creación de un nuevo proyecto

Introduzca el nombre del proyecto en el campo de texto designado después de elegir la ubicación del archivo. A continuación, como se ve en el ejemplo siguiente, haga clic en el botón Crear y elija el .NET Framework necesario.

Cómo crear un archivo DOCX en C#: Figura 2 - Configuración del nombre del proyecto y la ruta del archivo

La organización del proyecto de Visual Studio dependerá entonces de la aplicación seleccionada. Para añadir código y construir la aplicación, basta con abrir el archivo program.cs. Se puede utilizar la aplicación de Internet, Windows o la consola.

Después, se puede añadir la biblioteca y probar el código.

Instalar la biblioteca IronWord

Uso de la herramienta Visual Studio Seleccione NuGet Package Manager en el menú Herramientas. Acceda a la interfaz del gestor de paquetes para acceder a la consola del terminal de gestión de paquetes.

Install-Package IronWord

Una vez descargado e instalado el paquete, ya puede utilizarse en el proyecto en curso.

Cómo crear un archivo DOCX en C#: Figura 3 - Instalación de IronWord con la consola del gestor de paquetes

También existe el método del gestor de paquetes. La instalación del paquete directamente en la solución es posible con la opción NuGet Package Manager de Visual Studio. Puedes ver cómo lanzar el Gestor de Paquetes NuGet en la siguiente imagen.

Cómo crear un archivo DOCX en C#: Figura 4 - Cómo encontrar el gestor de paquetes NuGet

Utilice el cuadro de búsqueda del sitio web de NuGet para localizar paquetes. Todo lo que tenemos que hacer es buscar "IronWord" en el gestor de paquetes, como ilustra la siguiente captura de pantalla:

Cómo crear un archivo DOCX en C#: Figura 5 - Instalación de IronWord con el gestor de paquetes NuGet

La lista de resultados de búsqueda relevantes se muestra en la imagen superior. Para instalar el software en su máquina, sólo tiene que ajustar estos parámetros.

Crear DOCX con IronWord

Instanciar un objeto WordDocument para iniciar un nuevo documento Word. Para inicializar el documento, puede utilizar cualquier objeto que componga la estructura del documento, como un párrafo, una tabla o una sección. He aquí una ilustración sencilla en el siguiente fragmento de código:

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
Imports IronWord
Imports IronWord.Models
Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			' Create a new document
			Dim doc As New WordDocument(paragraph)
			' Export the DOCX file
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
VB   C#

Podemos añadir texto al documento con la ayuda de la clase TextRun, que nos permite pasar el texto al objeto párrafo con la ayuda del método AddTextRun. A continuación, creamos un nuevo objeto WordDocument para crear un nuevo archivo DOCX. A continuación, mediante el método SaveAs, podemos guardar el nuevo documento DOCX en la ubicación deseada. A continuación se muestra la salida generada a partir del código anterior.

Cómo crear un archivo DOCX en C#: Figura 6 - PDF resultante del código anterior

Para saber más sobre el código IronWord aquí.

Conclusión

En esta guía hemos visto cómo utilizar C# para generar un archivo de documento DOCX. Se han tratado los fundamentos del formato DOCX, junto con el Open XML SDK y la biblioteca DocX, y se han dado ejemplos de cómo utilizarlos para generar, editar y guardar archivos DOCX.

Todas estas herramientas y métodos te colocarán en una posición sólida para manejar una variedad de tareas de creación de documentos en tus proyectos de C#. Aprender la producción de documentos en C# es una habilidad útil que le ayudará en diversas situaciones, ya sea automatizando la generación de informes, desarrollando sistemas de gestión de documentos o simplemente creando plantillas para usuarios finales.

Para desarrolladores que trabajan con .NET C#, IronWord es una biblioteca de documentos Word potente y adaptable. Permite a los desarrolladores leer, escribir y editar Word (DOCX) documentos en sus aplicaciones con facilidad. La sencilla API de IronWord facilita el procesamiento de documentos Word. Sin necesidad de tener instalado Microsoft Word ni depender de Office Interop, los desarrolladores pueden crear y editar archivos de Word directamente dentro de sus proyectos .NET. Añadir texto, párrafos y otros elementos a nuevos documentos de Word es muy sencillo.

IronWord es $749 cuando sale por primera vez. Además, los clientes que paguen una cuota de afiliación de un año pueden recibir asistencia y actualizaciones sobre los productos. A cambio de una cuota, IronWord ofrece una defensa contra la redistribución incontrolada. Para obtener más información sobre el coste aproximado, visite este enlace página. Más información sobre Iron Software **Enlace.

< ANTERIOR
Cómo realizar la automatización de Word en C#
SIGUIENTE >
Cómo crear un documento de Word mediante programación en VB .NET

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

Descarga gratuita de NuGet Descargas totales: 6,076 Ver licencias >