1. IronWord
  2. Guías
  3. Agregar Tabla
Cómo Añadir Tabla a DOCX C# | IronWord

Cómo agregar una tabla a DOCX usando C# con IronWord

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

Una tabla es una cuadrícula de celdas organizadas en filas y columnas. Se utiliza para organizar y presentar información en un formato estructurado. Cada intersección de una fila y una columna es una celda, que puede contener texto, números u otros tipos de datos. Las tablas se usan comúnmente para organizar datos de manera ordenada, crear horarios o formatear información de una manera visualmente organizada.

como-título:2(Inicio Rápido: Crear y Guardar una Tabla con Una Llamada)

Este ejemplo muestra lo fácil que es crear una tabla en IronWord—simplemente constrúyela con tamaño, establece tus estilos, agrega contenido, colócala en un documento y guarda. Tendrás un DOCX con una tabla estilizada en minutos.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronWord con el gestor de paquetes NuGet

    PM > Install-Package IronWord

  2. Copie y ejecute este fragmento de código.

    var table = new IronWord.Models.Table(3,4);
var doc = new IronWord.WordDocument();
doc.AddTable(table);
doc.SaveAs("QuickTable.docx");

  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronWord en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Flujo de trabajo mínimo (5 pasos)

  1. Descargar una biblioteca C# para añadir tablas a DOCX
  2. Rellenar celdas con contenido y ensamblar celdas en filas
  3. Crear una tabla añadiendo filas a ella
  4. Inicializar un nuevo documento de Word con la tabla e insertar la tabla
  5. Exportar el documento de Word final

Ejemplo de agregar tabla

Una tabla es un componente significativo de un documento de Word. Primero, instanciar la clase Table proporcionando el número de filas y columnas. A partir de ahí, el estilo de la tabla, como color de fondo, sombreado, borde, franjas de cebra y ancho, se puede personalizar. En segundo lugar, se puede acceder a cada celda de la tabla de una manera muy intuitiva especificando la fila y columna de la tabla en formato [fila, columna]. En cada celda, se pueden añadir texto, imágenes, formas, párrafos o incluso tablas enteras. Finalmente, esta tabla se puede añadir al documento de Word.

ConsejosTodas las posiciones de índice de filas y columnas siguen una indexación basada en cero.

:path=/static-assets/word/content-code-examples/how-to/add-table-add-table.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

WordDocument doc = new WordDocument();

// Create table
Table table = new Table(5, 3);

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

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

// Apply styling
table.Zebra = new ZebraColor("FFFFFF", "dddddd");
table.Borders = tableBorders;

// Populate table
table[0, 0] = new TableCell(new TextContent("Number"));
table[0, 1] = new TableCell(new TextContent("First Name"));
table[0, 2] = new TableCell(new TextContent("Last Name"));
for (int i = 1; i < table.Rows.Count; i++)
{
    table[i, 0].AddChild(new TextContent($"{i}"));
    table[i, 1].AddChild(new TextContent($"---"));
    table[i, 2].AddChild(new TextContent($"---"));
}

// Add table
doc.AddTable(table);

doc.Save("document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

Private doc As New WordDocument()

' Create table
Private table As New Table(5, 3)

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

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

' Apply styling
table.Zebra = New ZebraColor("FFFFFF", "dddddd")
table.Borders = tableBorders

' Populate table
table(0, 0) = New TableCell(New TextContent("Number"))
table(0, 1) = New TableCell(New TextContent("First Name"))
table(0, 2) = New TableCell(New TextContent("Last Name"))
For i As Integer = 1 To table.Rows.Count - 1
	table(i, 0).AddChild(New TextContent($"{i}"))
	table(i, 1).AddChild(New TextContent($"---"))
	table(i, 2).AddChild(New TextContent($"---"))
Next i

' Add table
doc.AddTable(table)

doc.Save("document.docx")
$vbLabelText   $csharpLabel
Añadir tabla

El método AddChild de la clase TableCell acepta un objeto ContentElement, que incluye todo desde párrafos, imágenes y formas hasta la propia tabla. En este caso, puedes tener tablas anidadas, proporcionando una ilustración muy útil para ciertos casos de uso.

Estilos disponibles

Fronteras

Explora todas las opciones disponibles para valores de borde que se pueden establecer utilizando el enum BorderValues:

Valores fronterizos

Preguntas Frecuentes

¿Cómo puedo añadir una tabla a un documento de Word usando C#?

Puedes añadir una tabla a un documento de Word usando IronWord descargando la biblioteca C#, llenando celdas con contenido, ensamblándolas en filas y creando una tabla añadiendo estas filas. Una vez establecida la estructura de la tabla, inicialízala en un nuevo documento de Word y exporta el documento.

¿Qué opciones de estilo están disponibles para tablas en IronWord?

IronWord te permite personalizar tablas con varias opciones de estilo como color de fondo, sombreado, bordes, rayado tipo cebra y ancho.

¿Cómo añado contenido a una celda en específico en una tabla usando C#?

En IronWord, puedes usar el método AddChild de la clase TableCell para añadir contenido como texto, imágenes, formas o incluso tablas enteras a una celda específica.

¿Puedo anidar tablas dentro de otras tablas de forma programática usando IronWord?

Sí, IronWord te permite anidar tablas dentro de otras tablas, lo cual puede ser particularmente útil para diseños complejos de documentos.

¿Cuál es el formato de indexación para acceder a las celdas de tabla en IronWord?

IronWord utiliza indexación basada en cero para acceder a las celdas de tabla, especificado en un formato [fila, columna].

¿Cómo puedo establecer estilos de borde para tablas en un documento Word usando C#?

Puedes establecer estilos de borde para tablas en IronWord usando el enum BorderValues, que ofrece varias opciones para personalizar los bordes de las tablas.

¿Qué método se usa para guardar un documento de Word después de añadir una tabla con IronWord?

Después de añadir una tabla a un documento de Word usando IronWord, puedes guardar el documento usando el método Save con el nombre de archivo deseado, como document.Save('ExampleTable.docx').

¿Qué tipos de contenido pueden añadirse a una celda de tabla en IronWord?

En IronWord, puedes añadir varios tipos de contenido a una celda de tabla, incluyendo texto, imágenes, formas, párrafos e incluso tablas anidadas.

¿Cómo se inicializa una tabla en IronWord?

Para inicializar una tabla en IronWord, instancia la clase Table proporcionando el número de filas y columnas. Por ejemplo, var table = new Table(3, 3) crea una tabla de 3x3.

¿Cuál es el proceso para exportar un documento de Word con una tabla usando C#?

Para exportar un documento de Word con una tabla usando IronWord, primero crea y estiliza la tabla, inicialízala en el documento Word y luego usa el método Save para exportar el documento como un archivo .docx.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 27,129 | Version: 2025.11 recién lanzado