.NET Word API (Cómo funciona para los desarrolladores)

Introducción

En **API de Word .NET proporciona a los desarrolladores herramientas sólidas para convertir documentos de Word, interactuar con ellos y manipularlos dentro de sus aplicaciones. Esta API está diseñada para agilizar el proceso de trabajo con documentos de Microsoft Word, facilitando la creación, edición, conversión y gestión de documentos mediante programación. En este artículo exploraremos IronWord para comprender sus capacidades en la manipulación de documentos Word.

Introducción a IronWord

IronWord es una biblioteca .NET Word dentro del ecosistema .NET Word API, diseñada específicamente para desarrolladores que procesan documentos de Microsoft Word en sus aplicaciones .NET. Con IronWord, los desarrolladores pueden leer, escribir y modificar fácilmente documentos de Word sin necesidad de tener Microsoft Word instalado en el servidor o en los equipos cliente. Esta capacidad es especialmente beneficiosa para las aplicaciones que necesitan automatizar tareas de procesamiento de documentos, como la generación de informes, facturas o correspondencia personalizada mediante funciones de combinación de correspondencia.

Características de IronWord

IronWord ofrece una amplia gama de funciones que cubren varios aspectos de la manipulación de documentos Word. Exploremos cada conjunto de funciones, centrándonos en cómo permiten manipular y fusionar varios documentos, clasificados en "Estructura del documento" y "Elementos del documento".

Estructura del documento

Leer y editar Word: Con IronWord, puede extraer información específica de sus documentos de Word, como extraer texto para editarlo o reutilizarlo y recuperar imágenes que puedan necesitar ser utilizadas en otro lugar. Esta capacidad es vital para las aplicaciones destinadas a fusionar documentos Word y procesar la información contenida en los archivos DOCX existentes.

Múltiples formatos: IronWord es compatible con una amplia gama de formatos de archivo, lo que mejora su utilidad en la conversión de documentos de Word dentro de aplicaciones .NET.

Editar configuración de página: Adaptar el diseño físico de sus documentos de Word es sencillo con IronWord. Puede ajustar el tamaño del papel de varios archivos de MS Word a dimensiones estándar o personalizadas, cambiar la orientación de las distintas secciones del documento, establecer los márgenes para garantizar una alineación correcta e incluso modificar el color de fondo con fines estéticos o para resaltar secciones.

Añadir párrafos: IronWord permite añadir y eliminar el texto corre dentro de los párrafos que es esencial para editar y dar formato a grandes secciones de texto. Además, puede mejorar sus párrafos insertando imágenes y formas directamente en el texto, ajustando el estilo para que coincida con sus especificaciones de diseño y estableciendo alineaciones para conseguir un aspecto pulido. La posibilidad de añadir viñetas y listas numeradas también ayuda a organizar el contenido de forma más eficaz.

using IronWord;
using IronWord.Models;
//  Cargar docx
WordDocument doc = new WordDocument();
//  Crear y añadir texto con estilo a un párrafo
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
//  Añadir párrafo y exportar docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

using IronWord;
using IronWord.Models;
//  Cargar docx
WordDocument doc = new WordDocument();
//  Crear y añadir texto con estilo a un párrafo
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
//  Añadir párrafo y exportar docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

Imports IronWord
Imports IronWord.Models
'  Cargar docx
Private doc As New WordDocument()
'  Crear y añadir texto con estilo a un párrafo
Private paragraph As New Paragraph()
paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
'  Añadir párrafo y exportar docx
doc.AddParagraph(paragraph)
doc.SaveAs("newdocument.docx")

Añadir Tablas: Tablas son un componente fundamental de los archivos DOCX y se manipulan fácilmente con IronWord, permitiendo la generación dinámica de documentos. Puede añadir o eliminar filas y columnas, una operación que resulta clave para la generación dinámica de documentos, donde la cantidad de datos puede variar. La fusión y división de celdas le ofrece la versatilidad necesaria para dar formato a tablas complejas, y la personalización de los bordes y las dimensiones del diseño permite obtener un aspecto pulido y profesional.

using IronWord;
using IronWord.Models;
//  Crear una celda de tabla con un párrafo que contenga texto
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
//  Configurar un estilo de borde común para la tabla
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
//  Aplicar el estilo de borde a la celda
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
//  Crear una fila de tabla y añadir la misma celda dos veces
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
//  Cree una tabla, añada la fila y, a continuación, cree y exporte el documento de Word
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

using IronWord;
using IronWord.Models;
//  Crear una celda de tabla con un párrafo que contenga texto
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
//  Configurar un estilo de borde común para la tabla
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
//  Aplicar el estilo de borde a la celda
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
//  Crear una fila de tabla y añadir la misma celda dos veces
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
//  Cree una tabla, añada la fila y, a continuación, cree y exporte el documento de Word
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

Imports IronWord
Imports IronWord.Models
'  Crear una celda de tabla con un párrafo que contenga texto
Private cell As New TableCell(New Paragraph(New TextRun("Sample text")))
'  Configurar un estilo de borde común para la tabla
Private borderStyle As New BorderStyle With {
	.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
	.BorderValue = IronWord.Models.Enums.BorderValues.Thick,
	.BorderSize = 5
}
'  Aplicar el estilo de borde a la celda
cell.Borders = New TableBorders With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}
'  Crear una fila de tabla y añadir la misma celda dos veces
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)
'  Cree una tabla, añada la fila y, a continuación, cree y exporte el documento de Word
Dim table As New Table()
table.AddRow(row)
Dim doc As New WordDocument(table)
doc.SaveAs("Document.docx")

Elementos del documento

Añadir TextRuns: Esta característica es todo sobre el control de grano fino sobre el contenido del texto. Puede añadir, anexar y dividir tiradas de texto, lo que es vital para la creación dinámica de documentos. Las opciones de estilo son amplias, e incluyen cambiar familias de fuentes, tamaños y colores, así como añadir negrita, cursiva y otras decoraciones de texto. También puede incrustar imágenes dentro de tiradas de texto, creando un documento rico y visualmente atractivo.

Añadir imágenes: IronWord permite **Manipulación de imágenes dentro de documentos Word. Puedes cargar imágenes de distintas fuentes, rodearlas de texto sin problemas y ajustar sus dimensiones para adaptarlas a tu diseño. La posibilidad de establecer el desplazamiento de posición y la distancia desde las esquinas del documento significa que sus imágenes estarán siempre perfectamente colocadas.

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, //  En píxel unitario
    Height = 200 //  En píxel unitario
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, //  En píxel unitario
    Height = 200 //  En píxel unitario
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
Private image As New IronWord.Models.Image("your-image.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph, add, add, [and] As Create
paragraph.AddImage(image)
doc.AddParagraph(paragraph)
doc.SaveAs("save_document.docx")

Añadir formas: Las formas pueden añadir un impacto visual significativo a un documento, y IronWord le ofrece las herramientas para insertarlas y personalizarlas con precisión. Puede establecer el tipo de forma (como rectángulos, círculos, flechas, etc.)Además, podrá determinar cómo debe envolver el texto la forma, especificar las dimensiones y la posición exactas e incluso girar las formas para conseguir el efecto visual deseado.

Compatibilidad

Versiones .NET y tipos de proyecto

IronWord está diseñado para ofrecer una amplia compatibilidad con el ecosistema .NET, ya que admite C#, VB.NET y F# en varias versiones de .NET, incluidas .NET Core, .NET Standard y .NET Framework. Esto garantiza su utilidad tanto en aplicaciones actuales como heredadas. La versatilidad de la biblioteca se extiende a los tipos de proyectos, dando cabida a aplicaciones web, móviles y de escritorio mediante la integración con Blazor, WebForms, Xamarin, MAUI, WPF y aplicaciones de consola.

Entornos de aplicación

En cuanto a los entornos de aplicación, IronWord se adapta a las plataformas Windows, Linux, iOS y Android, incluida la compatibilidad específica con la contenedorización y el despliegue en la nube en Docker, Azure y AWS. Este amplio apoyo facilita el desarrollo en distintos entornos.

SO E IDE

IronWord también es compatible con los principales Entornos de Desarrollo Integrado (IDEs) como Microsoft Visual Studio, ReSharper y Rider, lo que ofrece a los desarrolladores flexibilidad a la hora de elegir herramientas. Por último, es compatible con varios sistemas operativos y arquitecturas de procesador. (x64, x86, ARM)garantizando un rendimiento eficaz en distintas configuraciones de hardware.

Opciones de licencia

IronWord ofrece varias opciones de licencia para adaptarse a las necesidades de los distintos desarrolladores y organizaciones. Ofrecen una licencia perpetua, lo que significa que pagas una vez y no hay cuotas recurrentes. Cada licencia incluye un año de asistencia técnica y actualizaciones del producto. Los niveles de licencia están diseñados en función del número de desarrolladores, ubicaciones y proyectos que tenga. También puede obtener un **Prueba gratuita para adquirir experiencia práctica antes de comprar una licencia.

Licencia Lite

Esta opción está pensada para desarrolladores individuales que trabajan en solitario en un proyecto. Su precio es de $599 y cubre a un desarrollador en una única ubicación.

Licencia Plus

Dirigida a equipos pequeños, esta licencia, por 1.499 dólares, admite hasta tres desarrolladores y se puede utilizar en tres ubicaciones y en tres proyectos.

Licencia profesional

Para equipos más grandes, la licencia profesional tiene un precio de 2.999 dólares y admite hasta diez desarrolladores. Está diseñado para operaciones de mayor envergadura e incluye funciones de asistencia premium.

Conclusión

Para terminar, IronWord surge como una API .NET Word robusta y flexible, que ofrece una gama de opciones de licencia para satisfacer las diversas necesidades de desarrolladores individuales y equipos. Sus funciones permiten gestionar y manipular eficazmente documentos de Word, garantizando la compatibilidad entre múltiples versiones de .NET y tipos de proyecto.