Introducción a IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord: Biblioteca de documentos de Word for .NET

IronWord es una biblioteca de documentos Word desarrollada por Iron Software. IronWord se destaca al proporcionar una funcionalidad robusta para trabajar con documentos Word en aplicaciones .NET.

  • Cargar, Manipular y Guardar Documentos Word y Docx.
  • PageSetup: Configurar el tamaño del papel, la orientación de la página, los márgenes y el color de fondo.
  • TextRun: Manejo de contenido de texto, estilos, división, adición de texto y adición de imágenes.
  • TextStyle: Administrar la familia de fuentes, tamaño, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
  • Paragraph: Agregar textos, imágenes, formas, establecer estilos, alineaciones, viñetas y listas de numeración.
  • Table: Manipular la estructura de la tabla, incluyendo agregar filas, obtener y establecer valores de celdas, eliminar filas, fusionar celdas y más.
  • Image: Cargar imágenes desde archivos o transmisiones, configurar el texto ajustado, el desplazamiento de posición, el ancho, la altura y otras propiedades.
  • Shape: Configuración del texto de ajuste, desplazamiento de posición, ancho, alto, tipo de forma y rotación.

Instalación

Biblioteca IronWord

Instalar IronWord es rápido y fácil. Puedes instalar el paquete usando NuGet con el siguiente comando:

Install-Package IronWord

Alternativamente, descarga directamente desde el sitio web oficial de IronWord NuGet.

Una vez instalado, puede comenzar agregando using IronWord; en la parte superior de su archivo de código C#.

Aplicar clave de licencia

A continuación, aplique una licencia válida o una clave de prueba a IronWord asignando la clave de licencia a la propiedad LicenseKey de la clase License. Incluye el siguiente código justo después de la declaración de importación, antes de usar cualquier método de IronWord:

using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
$vbLabelText   $csharpLabel

Ejemplos de código

Exploremos algunos ejemplos de código y las funciones disponibles.

Por favor notaEl archivo DOCX producido por IronWord, cuando se abre en una cierta versión de Microsoft Word, puede estar en Modo de Compatibilidad, lo que hace que algunos de los estilos no estén disponibles. Para convertir un documento de Word fuera del modo de compatibilidad

  1. Selecciona 'Archivo' > 'Información' y haz clic en "Convertir".
  2. Se te mostrará un mensaje diciendo que tu documento se actualizará al último formato de archivo. Haz clic en "OK".

Crear documentos de Word y Docx

Cree el documento de Word instanciando la clase WordDocument usando uno de sus constructores. Después de eso, use el método SaveAs para exportar el documento de Word. Ejemplo:

using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}
using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}
$vbLabelText   $csharpLabel

Añadir imagen

Una imagen no se puede añadir por sí sola; En su lugar, debe agregarse a una de las estructuras del documento, como Paragraph, TableCell o Section. Utilice el método AddImage para agregar una imagen. Ejemplo:

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}
using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}
$vbLabelText   $csharpLabel

Agregar tabla

Agregar una tabla requiere crear la tabla, filas, columnas y celdas de tabla. Esto habilita significativas oportunidades de configuración, ya que cada celda puede tener diferentes estilos. Ejemplo:

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}
using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}
$vbLabelText   $csharpLabel

Licencias y soporte disponibles

IronWord es una biblioteca de pago; sin embargo, las licencias de prueba gratuitas están disponibles aquí.

Para obtener más información sobre Iron Software, visita nuestro sitio web: https://ironsoftware.com/. Para más soporte y consultas, por favor pregunta a nuestro equipo.

Soporte de Iron Software

Para soporte general y consultas técnicas, por favor envíanos un correo electrónico a: support@ironsoftware.com

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 36,374 | Versión: 2026.3 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronWord
ejecuta una muestra observa cómo tus datos se convierten en un documento de Word.