1. IronWord
  2. Comenzar

Primeros pasos con IronWord

IronWord: Biblioteca de documentos Word para .NET

IronWord es una biblioteca de documentos Word desarrollada por Iron Software. IronWord destaca por su sólida funcionalidad para trabajar con documentos de Word en aplicaciones .NET.

  • Cargar, manipular y guardar documentos Word y Docx.
  • Configurar Página: Configuración del tamaño del papel, orientación de la página, márgenes y color de fondo.
  • TextRun: Manejo de contenido de texto, estilos, división, anexión de texto y adición de imágenes.
  • TextStyle: Gestión de la familia de fuentes, tamaño, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
  • Párrafo: Añadir tiradas de texto, imágenes, formas, establecer estilos, alineaciones, viñetas y numerar listas.
  • Tabla: Manipulación de la estructura de la tabla, incluyendo añadir filas, obtener y establecer valores de celda, eliminar filas, combinar celdas, etc.
  • Imagen: Carga de imágenes desde archivos o secuencias, configuración del texto de ajuste, desplazamiento de posición, anchura, altura y otras propiedades.
  • Forma: Configuración del texto de envoltura, desplazamiento de posición, anchura, altura, tipo de forma y rotación.

Biblioteca C# de documentos de Word para .NET

  1. Descargar la biblioteca C# para el tratamiento de documentos DOCX
  2. Crear y modificar documentos Word y DOCX
  3. Añadir estructuras de documento como párrafos, secciones y tablas
  4. Añadir elementos de documento como tiradas de texto, imágenes y formas
  5. Estiliza los elementos del documento con facilidad

Instalación

Biblioteca IronWord

La instalación de IronWord es rápida y sencilla, por favor, instale el paquete de la siguiente manera:

Install-Package IronWord

También puede descargarse directamente de Sitio web oficial de IronWord NuGet.

Una vez instalado, puede empezar añadiendo using IronWord; al principio de su código C#.

Aplicación de la 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. Incluya el siguiente código justo después de la sentencia import, antes de utilizar cualquier método IronWord:

:path=/static-assets/word/content-code-examples/get-started/get-started-license.cs
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01";
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01"
VB   C#

Ejemplos de códigos

Crear documentos Word y Docx

Crea el documento Word instanciando la clase WordDocument utilizando uno de sus constructores. A continuación, utilice el método SaveAs para exportar el documento Word.

:path=/static-assets/word/content-code-examples/get-started/get-started-1.cs
using IronWord;
using IronWord.Models;

// Crear textrun
Text textRun = new Text("Sample text");

Paragraph paragraph = new Paragraph();
paragraph.AddText(textRun);

// Crear un nuevo documento Word
WordDocument doc = new WordDocument(paragraph);

// Exportar docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Crear textrun
Private textRun As New Text("Sample text")

Private paragraph As New Paragraph()
paragraph.AddText(textRun)

' Crear un nuevo documento Word
Dim doc As New WordDocument(paragraph)

' Exportar docx
doc.SaveAs("document.docx")
VB   C#

Añadir imagen

Una imagen no puede añadirse sola; debe añadirse a una de las estructuras del documento, como Paragraph, TableCell o Section. Utilice el método AddImage para añadir una imagen.

:path=/static-assets/word/content-code-examples/get-started/get-started-2.cs
using IronWord;
using IronWord.Models;

// Cargar docx
WordDocument doc = new WordDocument("document.docx");

// Configurar imagen
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // En píxel unitario
image.Height = 200; // En píxel unitario
Paragraph paragraph = new Paragraph();

// Añadir imagen
paragraph.AddImage(image);

// Añadir párrafo
doc.AddParagraph(paragraph);

// Exportar docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Cargar docx
Private doc As New WordDocument("document.docx")

' Configurar imagen
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' En píxel unitario
image.Height = 200 ' En píxel unitario
Dim paragraph As New Paragraph()

' Añadir imagen
paragraph.AddImage(image)

' Añadir párrafo
doc.AddParagraph(paragraph)

' Exportar docx
doc.SaveAs("save_document.docx")
VB   C#

Añadir tabla

Añadir una tabla requiere un poco más de trabajo, ya que hay que crear la tabla, las filas, las columnas y las celdas de la tabla. Sin embargo, esta configuración ofrece importantes posibilidades de configuración. Cada celda puede tener un estilo diferente. Explore los distintos estilos de bordes, que ofrecen una amplia selección de 24 tipos.

:path=/static-assets/word/content-code-examples/get-started/get-started-3.cs
using IronWord;
using IronWord.Models;

// Crear celda de tabla
TableCell cell = new TableCell();

Text textRun = new Text();
textRun.Text = "Sample text";

// Añadir textrun a la celda
cell.AddChild(new Paragraph(textRun));

// Configurar el estilo del borde
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = new IronColor(IronSoftware.Drawing.Color.Black);
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configurar el borde de la tabla
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Crear fila y añadir celda
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

// Crear tabla y añadir fila
Table table = new Table();
table.AddRow(row);

// Crear un nuevo documento Word a partir de la tabla
WordDocument doc = new WordDocument(table);

// Exportar documento Word
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Crear celda de tabla
Private cell As New TableCell()

Private textRun As New Text()
textRun.Text = "Sample text"

' Añadir textrun a la celda
cell.AddChild(New Paragraph(textRun))

' Configurar el estilo del borde
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black)
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configurar el borde de la tabla
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Crear fila y añadir celda
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Crear tabla y añadir fila
Dim table As New Table()
table.AddRow(row)

' Crear un nuevo documento Word a partir de la tabla
Dim doc As New WordDocument(table)

' Exportar documento Word
doc.SaveAs("Document.docx")
VB   C#

Licencias y asistencia disponibles

IronWord es una biblioteca de pago, aunque también existen licencias de prueba gratuitas.aquí.

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

Asistencia de Iron Software

Para asistencia general y consultas técnicas, envíenos un correo electrónico a: support@ironsoftware.com