Introducción a IronWord

IronWord: Biblioteca de documentos de Word para .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: Configurando tamaño de papel, orientación de página, márgenes y color de fondo.
• TextRun: Manejo del contenido del texto, estilos, división, anexado de texto y adición de imágenes.
• TextStyle: Gestión de familia de fuente, tamaño, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
• Paragraph: Adición de ejecuciones de texto, imágenes, formas, ajuste de estilos, alineamientos, viñetas y listas numeradas.
• Table: Manipulación de la estructura de la tabla, incluidas la adición de filas, obtención y configuración de valores de celdas, eliminación de filas, fusión de celdas y más.
• Image: Carga de imágenes desde archivos o flujos, configuración de texto envolvente, desplazamiento de posición, ancho, altura y otras propiedades.
• Shape: Configuración de texto envolvente, desplazamiento de posición, ancho, altura, tipo de forma y rotación.

Instalación

Install-Package IronWord

Aplicar clave de licencia

A continuación, aplica una licencia válida o 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";

Imports IronWord

' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Ejemplos de código

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

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

Crea el documento Word instanciando la clase WordDocument usando uno de sus constructores. Después de eso, utiliza el método SaveAs para exportar el documento 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");
    }
}

Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim document = New WordDocument()

		' Save the document as a .docx file
		document.SaveAs("example.docx")
	End Sub
End Class

Añadir imagen

Una imagen no se puede añadir por sí sola; en su lugar, debe añadirse a una de las estructuras del documento, como un Paragraph, TableCell o Section. Usa el método AddImage para añadir 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");
    }
}

Imports IronWord
Imports System.Drawing

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()

		' Add an image to a paragraph
		Dim paragraph = section.Paragraphs.Add()
		paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))

		document.SaveAs("example_with_image.docx")
	End Sub
End Class

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");
    }
}

Imports IronWord

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()
		Dim table = section.Tables.Add(3, 3) ' 3x3 table

		' Iterate over cells and set their content
		For i As Integer = 0 To table.Rows.Count - 1
			Dim j As Integer = 0
			Do While j < table.Rows(i).Cells.Count
				table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
				j += 1
			Loop
		Next i

		document.SaveAs("example_with_table.docx")
	End Sub
End Class

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.