Cómo crear un archivo DOCX en C#

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".

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.

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.

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.

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:

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)
        {
            //  Crear una ejecución de texto
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            //  Crear un nuevo documento
            WordDocument doc = new WordDocument(paragraph);
            //  Exportar el archivo DOCX
            doc.SaveAs("document.docx");
        }
    }
}

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            //  Crear una ejecución de texto
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            //  Crear un nuevo documento
            WordDocument doc = new WordDocument(paragraph);
            //  Exportar el archivo DOCX
            doc.SaveAs("document.docx");
        }
    }
}

Imports IronWord
Imports IronWord.Models
Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			'  Crear una ejecución de texto
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			'  Crear un nuevo documento
			Dim doc As New WordDocument(paragraph)
			'  Exportar el archivo DOCX
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

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.

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 $599 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.