Muchas aplicaciones en el entorno digital actual requieren la capacidad de generar y modificar documentos automáticamente. La capacidad de crear y trabajar con archivos DOCX es útil ya sea que estés construyendo 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 con C# y examinaremos las robustas bibliotecas y métodos de programación que se pueden utilizar en C# para crear archivos DOCX.

How to Create DOCX File in C#

1. Instala el paquete NuGet IronWord.
2. Toma los espacios de nombres requeridos e imprtálos desde IronWord.
3. Para generar archivos de documento, agrega un nuevo TextRun.
4. Crea un nuevo Cuerpo y Documento.
5. Llena el Cuerpo con contenido (párrafos, tablas, etc.).
6. Usando WordDocument, crea un nuevo WordDocument.
7. Asignando el objeto Documento a la propiedad de Párrafo del Documento TextRun se guardarán las modificaciones.

Conociendo el formato DOCX

Antes de adentrarnos en la codificación, aclaremos qué es un archivo DOCX. Microsoft Word y otros programas de procesamiento de texto guardan documentos en el formato de archivo DOCX. Está basado en el estándar ZIP-comprimido de XML conocido como [Office Open XML (OOXML)](https://es.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.). Esto permite utilizar APIs de Microsoft y otros desarrolladores para manipularlo programáticamente de manera relativamente sencilla.

Palabra de hierro

Iron Software creó la biblioteca de documentos Word conocida como IronWord. Cuando se trata de ofrecer fuertes capacidades para la manipulación de documentos Word en aplicaciones .NET, IronWord destaca. 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

• Crear y editar DOC y DOCX: IronWord elimina el requisito de la instalación de Office Interop o Microsoft Word al permitir crear y editar documentos Word directamente en tus 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 página (color de fondo, márgenes, tamaño de papel y orientación).
• Incluir Palabras y Imágenes: Con la simple API, puedes agregar rápidamente texto y gráficos a tus documentos Word.
• Soporte 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.
• A nivel mundial, millones de ingenieros confían en nosotros: IronWord es un componente del Iron Suite, que consta de nueve productos de documentos API .NET. Los desarrolladores lo utilizan en todo el mundo para crear, ver y modificar documentos Word.

Para saber más sobre IronWord consulta aquí.

Crear un nuevo proyecto en Visual Studio

Para lanzar la aplicación Visual Studio, usa el menú Archivo y elige Archivo. Haz clic en 'Nuevo Proyecto', luego elige 'Aplicación de consola'.

Introduce el nombre del proyecto en el campo de texto designado después de elegir la ubicación del archivo. Luego, como se ve en el ejemplo a continuación, haz clic en el botón Crear y elige el .NET Framework requerido.

La organización del proyecto de Visual Studio dependerá de la aplicación seleccionada. Para agregar código y construir la aplicación, solo abre el archivo program.cs. La aplicación de internet, Windows o consola pueden ser usadas.

Después de eso, la biblioteca puede ser añadida y el código probado.

Instalar la biblioteca IronWord

Haciendo Uso de la Herramienta Visual Studio Selecciona el Administrador de Paquetes NuGet del menú Herramientas. Entra en la interfaz del administrador de paquetes para acceder a la terminal de gestión de paquetes.

Install-Package IronWord

Después de descargar e instalar el paquete, ahora puede utilizarse en el proyecto en curso.

También está el método del Administrador de Paquetes. Instalar el paquete directamente en la solución es posible con la opción del Administrador de Paquetes NuGet de Visual Studio. Puedes ver cómo lanzar el Administrador de Paquetes NuGet en la imagen a continuación.

Use el cuadro de búsqueda del sitio web de NuGet para localizar paquetes. Todo lo que necesitamos hacer es buscar 'IronWord' en el administrador de paquetes, como ilustra la captura de pantalla a continuación:

La lista de resultados de búsqueda relevantes se muestra en la imagen anterior. Para instalar el software en tu máquina, simplemente ajusta estas configuraciones.

Crear DOCX con IronWord

Instanciar un objeto WordDocument para comenzar un nuevo documento de Word. Para inicializar el documento, puedes usar cualquier objeto que componga la estructura del documento, como un párrafo, tabla o sección. Aquí hay una sencilla ilustración 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, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            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, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

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

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

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

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

Podemos agregar 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. Luego, creamos un nuevo objeto WordDocument para crear un nuevo archivo DOCX. Luego, utilizando 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 consulta aquí.

Conclusión

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

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

Para los desarrolladores que trabajan con .NET C#, IronWord es una potente y adaptable biblioteca de documentos Word. Permite a los desarrolladores leer, escribir y editar documentos Word (DOCX) en sus aplicaciones con facilidad. La API fácil de usar de IronWord hace que el procesamiento de documentos Word sea más sencillo. Sin requerir que Microsoft Word esté instalado o depender de Office Interop, los desarrolladores pueden crear y editar archivos Word directamente dentro de sus proyectos .NET. Agregar texto, párrafos y otros elementos a nuevos documentos Word se hace sencillo.

IronWord es $999 cuando se lanza por primera vez. Además, los clientes que pagan una tarifa de suscripción anual pueden recibir asistencia y actualizaciones en productos. Por una tarifa, IronWord ofrece una defensa contra la redistribución desenfrenada. Para saber más sobre el costo aproximado, visita esta página. Vea más sobre Iron Software haciendo clic en este enlace.