API de Word .NET (Cómo Funciona para Desarrolladores)

Estructura del documento

Leer y Editar Word: Con IronWord, puedes extraer información específica de tus documentos Word, como extraer texto para editar, reutilizar y recuperar imágenes que pueden necesitarse en otros lugares. Esta capacidad es vital para aplicaciones orientadas a la combinación de documentos Word y al procesamiento de la información contenida en archivos DOCX existentes.

Varios Formatos: IronWord admite una amplia gama de formatos de archivo, mejorando su utilidad en la conversión de documentos Word dentro de aplicaciones .NET.

Editar Configuración de Página: Diseñar la disposición física de tus documentos Word es sencillo con IronWord. Puedes ajustar el tamaño del papel para varios archivos MS Word a dimensiones estándar o personalizadas, cambiar la orientación para diferentes secciones de tu documento, establecer márgenes para asegurar una alineación adecuada e incluso modificar el color de fondo para propósitos estéticos o para resaltar secciones.

Agregar Párrafos: IronWord permite la adición y eliminación de fragmentos de texto dentro de los párrafos, lo cual es esencial para editar y dar formato a grandes secciones de texto. Además, puedes mejorar tus párrafos insertando imágenes y formas directamente en el texto, ajustando el estilo para que coincida con tus especificaciones de diseño y configurando alineaciones para un acabado pulido. La capacidad de agregar viñetas y listas numeradas también ayuda a organizar el contenido de manera más efectiva.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Load docx
		Dim doc As New WordDocument()
		' Create and add styled text to a paragraph
		Dim paragraph As New Paragraph()

		' Adding regular text
		paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))

		' Adding italic text
		paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))

		' Adding bold text
		paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))

		' Add paragraph to the document and export docx
		doc.AddParagraph(paragraph)
		doc.SaveAs("newdocument.docx")
	End Sub
End Class

Agregar Tablas: Las tablas son un componente crítico de los archivos DOCX y son fácilmente manipulables con IronWord, soportando la generación dinámica de documentos. Puedes agregar o eliminar filas y columnas, una operación fundamental para la generación dinámica de documentos donde la cantidad de datos puede variar. Combinar y dividir celdas te da la versatilidad para formatear tablas complejas, y personalizar bordes y dimensiones de diseño permite un aspecto pulido y profesional.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a table cell with a paragraph containing text
		Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

		' Configure a common border style for the table
		Dim borderStyle As New BorderStyle With {
			.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
			.BorderValue = IronWord.Models.Enums.BorderValues.Thick,
			.BorderSize = 5
		}

		' Apply the border style to the cell
		cell.Borders = New TableBorders With {
			.TopBorder = borderStyle,
			.RightBorder = borderStyle,
			.BottomBorder = borderStyle,
			.LeftBorder = borderStyle
		}

		' Create a table row and add the same cell twice
		Dim row As New TableRow()
		row.AddCell(cell)
		row.AddCell(cell)

		' Create a table, add the row, then create and export the Word document
		Dim table As New Table()
		table.AddRow(row)
		Dim doc As New WordDocument(table)
		doc.SaveAs("Document.docx")
	End Sub
End Class

Elementos del documento

Agregar TextRuns: Esta función se enfoca en el control detallado sobre el contenido del texto. Puedes agregar, adjuntar y dividir fragmentos de texto, lo cual es vital para la creación dinámica de documentos. Las opciones de estilo son extensas, incluyendo cambio de familias de fuentes, tamaños y colores, así como añadir negritas, itálicas y otras decoraciones de texto. También puedes incrustar imágenes dentro de fragmentos de texto, creando un documento rico y visualmente atractivo.

Agregar Imágenes: IronWord permite una manipulación de imágenes completa dentro de Documentos Word. Puedes cargar imágenes de diversas fuentes, ajustar el texto a su alrededor sin problemas, y ajustar sus dimensiones para que se adapten a tu diseño. La capacidad de establecer el desplazamiento de posición y la distancia desde las esquinas del documento asegura que tus imágenes siempre estarán perfectamente colocadas.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		Dim doc As New WordDocument()

		' Load and configure the image
		Dim image As New IronWord.Models.Image("your-image.jpg") With {
			.Width = 200,
			.Height = 200
		}

		' Create paragraph, add image, add paragraph to document, and export
		Dim paragraph As New Paragraph()
		paragraph.AddImage(image)

		' Add paragraph containing the image to the document
		doc.AddParagraph(paragraph)
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Agregar Formas: Las formas pueden añadir un impacto visual significativo a un documento, y IronWord te brinda las herramientas para insertar y personalizarlas con precisión. Puedes establecer el tipo de forma (como rectángulos, círculos, flechas, etc.), determinar cómo debe ajustarse el texto alrededor de la forma, especificar dimensiones y posición exacta, e incluso rotar formas para lograr el efecto visual deseado.

Versiones de .NET y tipos de proyectos

IronWord está diseñado para una amplia compatibilidad dentro del ecosistema .NET, soportando C#, VB.NET y F# a través de diversas versiones de .NET, incluyendo .NET Core, .NET Standard y .NET Framework. Esto asegura su utilidad tanto en aplicaciones contemporáneas como en legado. La versatilidad de la biblioteca se extiende a los tipos de proyectos, acomodando aplicaciones web, móviles y de escritorio a través de la integración con Blazor, WebForms, Xamarin, MAUI, WPF y aplicaciones de consola.

Entornos de aplicaciones

En términos de entornos de aplicación, IronWord es adaptable a plataformas Windows, Linux, iOS y Android, incluyendo soporte específico para la contenedorización y despliegue en la nube en Docker, Azure y AWS. Este amplio soporte facilita el desarrollo en diferentes entornos.

SO e IDE

IronWord también es compatible con los principales entornos de desarrollo integrados (IDEs) como Microsoft Visual Studio, ReSharper y Rider, ofreciendo a los desarrolladores flexibilidad en su elección de herramientas. Por último, soporta varios sistemas operativos y arquitecturas de procesador (x64, x86, ARM), asegurando un rendimiento eficiente a través de configuraciones de hardware diversas.

Licencia Lite

Esta opción está orientada a desarrolladores individuales que trabajan solo en un proyecto. Está valorada en $799 y cubre a un desarrollador en una sola ubicación.

Licencia Plus

Dirigida a pequeños equipos, esta licencia, por $plusLicense, acomoda hasta tres desarrolladores y es aplicable para su uso en tres ubicaciones en tres proyectos.

Licencia Profesional

Para equipos más grandes, la Licencia Profesional está valorada en $professionalLicense y soporta hasta diez desarrolladores. Está diseñada para satisfacer operaciones más amplias e incluye características de soporte premium.