# 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 tamaño del papel, orientación de la página, márgenes y color de fondo.
- `TextRun`: Manejar contenido de texto, estilos, división, anexado de texto y adición de imágenes.
- `TextStyle`: Gestionar familia de fuentes, tamaño, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
- `Paragraph`: Añadir bloques de texto, imágenes, formas, establecer estilos, alineaciones, viñetas y listas numeradas.
- `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 flujos, configurar ajuste de texto, desplazamiento de posición, ancho, altura y otras propiedades.
- `Shape`: Configurar ajuste de texto, desplazamiento de posición, ancho, altura, tipo de forma y rotación.
<div class="hsg-featured-snippet">
<h2>Biblioteca de documentos de Word C# for .NET</h2>
<ol>
<li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/IronWord/">Descargue la biblioteca C# para manejar documentos DOCX</a></li>
<li>Crear y modificar documentos Word y DOCX</li>
<li>Agregar estructuras de documentos como párrafos, secciones y tablas</li>
<li>Agregue elementos del documento, como textos, imágenes y formas.</li>
<li>Dale estilo a los elementos del documento con facilidad</li>
</ol>
</div>
## Instalación
### Biblioteca IronWord
Instalar IronWord es rápido y fácil. Puedes instalar el paquete usando NuGet con el siguiente comando:
```shell
:ProductInstall
```
Alternativamente, descarga directamente desde el [sitio web oficial de IronWord NuGet](https://www.nuget.org/packages/IronWord).
Una vez instalado, puede comenzar agregando `using IronWord;` al inicio de su archivo de código C#.
## Aplicar clave de licencia
A continuación, aplique una licencia válida o 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:
```csharp
using 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.
[[i:(El archivo DOCX producido por IronWord, cuando se abre en una cierta versión de Microsoft Word, puede estar en **Modo de Compatibilidad**, lo que hace que algunos de los estilos no estén disponibles. Para convertir un documento de Word fuera del modo de compatibilidad)]]
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 Word instanciando la clase `WordDocument` utilizando uno de sus constructores. Después de eso, utilice el método `SaveAs` para exportar el documento Word. Ejemplo:
```csharp
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");
}
}
```
## Añadir imagen
Una imagen no se puede añadir por sí sola; en su lugar, debe añadirse a una de las estructuras del documento, como un `Paragraph`, `TableCell`, o `Section`. Utilice el método `AddImage` para añadir una imagen. Ejemplo:
```csharp
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");
}
}
```
## 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:
```csharp
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");
}
}
```
## Licencias y soporte disponibles
**IronWord** es una biblioteca de pago; sin embargo, las licencias de prueba gratuitas están disponibles [aquí](trial-license).
Para obtener más información sobre Iron Software, visita nuestro sitio web: [https://ironsoftware.com/](https://ironsoftware.com/). Para más soporte y consultas, por favor [pregunta a nuestro equipo](https://www.ironsoftware.com/csharp/word/docs/#live-chat-support).
### Soporte de Iron Software
Para soporte general y consultas técnicas, por favor envíanos un correo electrónico a: [support@ironsoftware.com](mailto:support@ironsoftware.com)
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 tamaño del papel, orientación de la página, márgenes y color de fondo.
TextRun: Manejar contenido de texto, estilos, división, anexado de texto y adición de imágenes.
TextStyle: Gestionar familia de fuentes, tamaño, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
Paragraph: Añadir bloques de texto, imágenes, formas, establecer estilos, alineaciones, viñetas y listas numeradas.
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 flujos, configurar ajuste de texto, desplazamiento de posición, ancho, altura y otras propiedades.
Shape: Configurar ajuste de texto, desplazamiento de posición, ancho, altura, tipo de forma y rotación.
Una vez instalado, puede comenzar agregando using IronWord; al inicio de su archivo de código C#.
Aplicar clave de licencia
A continuación, aplique una licencia válida o 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 keyLicense.LicenseKey = "YOUR_LICENSE_KEY_HERE";
using IronWord;
// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
ImportsIronWord' Assign your license keyLicense.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.
Por favor nota: El archivo DOCX producido por IronWord, cuando se abre en una cierta versión de Microsoft Word, puede estar en Modo de Compatibilidad, lo que hace que algunos de los estilos no estén disponibles. Para convertir un documento de Word fuera del modo de compatibilidad
Selecciona 'Archivo' > 'Información' y haz clic en "Convertir".
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 Word instanciando la clase WordDocument utilizando uno de sus constructores. Después de eso, utilice el método SaveAs para exportar el documento Word. Ejemplo:
using IronWord;class Program{ static voidMain() { // 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");
}
}
ImportsIronWordFriend Class ProgramShared Sub Main() ' Create a new Word document Dim document = New WordDocument() ' Save the document as a .docx file document.SaveAs("example.docx") End SubEnd Class
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 añadirse a una de las estructuras del documento, como un Paragraph, TableCell, o Section. Utilice el método AddImage para añadir una imagen. Ejemplo:
using IronWord;using System.Drawing;class Program{ static voidMain() { 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");
}
}
ImportsIronWordImportsSystem.DrawingFriend Class ProgramShared 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 SubEnd Class
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 voidMain() { 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");
}
}
ImportsIronWordFriend Class ProgramShared 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 AsInteger = 0 To table.Rows.Count - 1 Dim j AsInteger = 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 SubEnd Class
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í.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.