1. IronWord
  2. Comenzar

Primeros pasos con IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

El archivo DOCX producido por IronWord, cuando se abre en una determinada versión de Microsoft Word, puede estar en Modo de compatibilidad, provocando que algunos de los estilos no estén disponibles. Para convertir un documento Word fuera del modo de compatibilidad:

  1. Selecciona "Archivo" > "Información" y haz clic en "Convertir"
  2. Aparecerá un mensaje informándole de que su documento se actualizará al formato de archivo más reciente. Haga clic en "Aceptar"

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;

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

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

// Create a new Word document
WordDocument doc = new WordDocument(paragraph);

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

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

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

' Create a new Word document
Dim doc As New WordDocument(paragraph)

' Export 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;

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

// Configure image
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // In unit pixel
image.Height = 200; // In unit pixel
Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

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

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

' Configure image
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export 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;

// Create table cell
TableCell cell = new TableCell();

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

// Add textrun to the cell
cell.AddChild(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Create row and add cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

// Create table and add row
Table table = new Table();
table.AddRow(row);

// Create new Word document from the table
WordDocument doc = new WordDocument(table);

// Export Word document
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Create table cell
Private cell As New TableCell()

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

' Add textrun to the cell
cell.AddChild(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Create row and add cell
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Create table and add row
Dim table As New Table()
table.AddRow(row)

' Create new Word document from the table
Dim doc As New WordDocument(table)

' Export Word document
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