Introducción a IronWord

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

Install-Package IronWord

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

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

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

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

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.