Saltar al pie de página
USANDO IRONWORD

Cómo Crear Archivo DOCX en C#

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.

Cómo crear un archivo DOCX en 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'.

Cómo Crear un Archivo DOCX en C#: Figura 1 - Creando un nuevo proyecto

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.

Cómo Crear un Archivo DOCX en C#: Figura 2 - Configurando el nombre del proyecto y la ruta del archivo

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.

Cómo Crear un Archivo DOCX en C#: Figura 3 - Instalando IronWord con la consola del administrador de paquetes

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.

Cómo Crear un Archivo DOCX en C#: Figura 4 - Cómo encontrar el administrador de paquetes NuGet

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:

Cómo Crear un Archivo DOCX en C#: Figura 5 - Instalando IronWord con el administrador de paquetes NuGet

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 iniciar un nuevo documento 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
$vbLabelText   $csharpLabel

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 estamos creando un nuevo objeto WordDocument para crear un nuevo archivo DOCX. Luego, usando 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 generado 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 $799 cuando primero sale. 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.

Preguntas Frecuentes

¿Cómo puedo generar un archivo DOCX usando C#?

Para generar un archivo DOCX usando C#, puedes utilizar la biblioteca IronWord. Comienza instalando el paquete NuGet IronWord, importa los espacios de nombres requeridos e inicia un objeto WordDocument. Luego puedes agregar contenido usando métodos como AddTextRun y guardar el documento con el método SaveAs.

¿Cuáles son los beneficios de usar IronWord para la generación de archivos DOCX?

IronWord ofrece varios beneficios para la generación de archivos DOCX, incluyendo la capacidad de crear y editar documentos sin Microsoft Word, soporte multiplataforma y una API fácil de usar que simplifica el proceso de creación de documentos.

¿Puedo agregar imágenes a un archivo DOCX usando IronWord?

Sí, IronWord te permite agregar imágenes a un archivo DOCX. Puedes usar el método AddImage para incorporar imágenes en tu documento, lo que puede mejorar el atractivo visual y la funcionalidad de tus archivos DOCX.

¿Es posible editar archivos DOCX existentes con IronWord?

Sí, IronWord te permite editar archivos DOCX existentes. Puedes abrir un archivo DOCX usando IronWord, modificar su contenido, estructura o formato, y luego guardar los cambios.

¿IronWord soporta la generación de documentos en Linux?

Sí, IronWord soporta la generación de documentos en Linux como parte de sus capacidades multiplataforma, permitiendo a los desarrolladores crear y manipular archivos DOCX en varios sistemas operativos, incluyendo Linux.

¿Qué pasos están involucrados en configurar IronWord en un proyecto C#?

Configurar IronWord en un proyecto C# implica instalar el paquete IronWord NuGet a través del Gestor de Paquetes NuGet, importar los espacios de nombres necesarios en tu código y utilizar la API de IronWord para realizar tareas de creación y edición de documentos.

¿Cómo maneja IronWord la compatibilidad con archivos DOCX?

IronWord está diseñado para ser compatible con el formato DOCX, asegurando que los archivos creados o editados con IronWord puedan abrirse y usarse en Microsoft Word y otros procesadores de texto compatibles.

Jordi Bardia
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más