Trabajar con ListObject de Excel
Los ListObjects de Excel (tablas) ofrecen una forma estructurada de organizar conjuntos de datos. Incluyen características como la organización automática de datos, filas de encabezado, filtros integrados y filas de totales opcionales. Domine estas capacidades para analizar sus datos rápidamente y de manera eficiente.
Definición de ListObject: Un ListObject es el objeto nativo de tabla de Excel que agrupa filas y columnas, permite ordenar, filtrar y aplicar estilos, y puede accederse mediante la API de Aspose.Cells Cloud.
Cómo trabajar con tabla (ListObject)
- Cómo agregar una tabla (ListObject) dentro de la hoja de cálculo
- Cómo actualizar una tabla (ListObject) dentro de la hoja de cálculo
- Cómo convertir una tabla (ListObject) en un rango
- Cómo ordenar los datos de la tabla
- Cómo eliminar filas duplicadas de una tabla
- Cómo insertar un segmentador para una tabla
Referencia de la API (resumen):
La API REST de Aspose.Cells Cloud expone operaciones de ListObject mediante puntos finales como GET /cells/{fileName}/worksheets/{sheetName}/listobjects, POST /cells/{fileName}/worksheets/{sheetName}/listobjects, PUT /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex} y DELETE /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Los parámetros de consulta obligatorios son folder y storage. Los cuerpos de solicitud son objetos JSON que describen las propiedades de la tabla (nombre, showHeaderRow, showTotalRow, etc.), y las respuestas devuelven cargas útiles JSON con los detalles del ListObject creado o modificado.
Prerrequisitos:
- Un token válido de autenticación de Aspose.Cells Cloud.
- El archivo del libro debe cargarse en una ubicación de almacenamiento compatible (predeterminada: /) y el parámetro de consulta
folderdebe apuntar a dicha ubicación. - Opcional: establezca
storagesi utiliza un servicio de almacenamiento distinto al predeterminado.
Detalles del punto final
| Método | Punto final | Parámetros de consulta | Cuerpo de solicitud (JSON) | Respuesta correcta (ejemplo) | Códigos de estado |
|---|---|---|---|---|---|
| GET | /cells/{fileName}/worksheets/{sheetName}/listobjects |
folder (obligatorio), storage (opcional) |
ninguno | { "ListObjects": [ { "Name": "Table1", "ShowHeaderRow": true, "ShowTotalRow": false, ... } ] } |
200 – OK, 400 – Solicitud incorrecta, 401 – No autorizado, 404 – No encontrado |
| POST | /cells/{fileName}/worksheets/{sheetName}/listobjects |
folder (obligatorio), storage (opcional) |
{ "Name": "Table1", "StartRow": 0, "StartColumn": 0, "TotalRows": 10, "TotalColumns": 5, "ShowHeaderRow": true, "ShowTotalRow": false } |
{ "Code": 200, "Status": "OK", "ListObject": { "Name": "Table1", "ShowHeaderRow": true, ... } } |
201 – Creado, 400 – Solicitud incorrecta, 401 – No autorizado, 409 – Conflicto |
| PUT | /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex} |
folder (obligatorio), storage (opcional) |
{ "Name": "UpdatedTable", "ShowTotalRow": true } |
{ "Code": 200, "Status": "OK", "ListObject": { "Name": "UpdatedTable", "ShowTotalRow": true, ... } } |
200 – OK, 400 – Solicitud incorrecta, 401 – No autorizado, 404 – No encontrado |
| DELETE | /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex} |
folder (obligatorio), storage (opcional) |
ninguno | { "Code": 200, "Status": "Deleted" } |
200 – OK, 400 – Solicitud incorrecta, 401 – No autorizado, 404 – No encontrado |
Fragmentos de código
C# (POST – Agregar ListObject)
var api = new CellsApi("client_id", "client_secret");
var request = new ListObject
{
Name = "MyTable",
StartRow = 0,
StartColumn = 0,
TotalRows = 20,
TotalColumns = 5,
ShowHeaderRow = true,
ShowTotalRow = false
};
var response = api.PostWorksheetListObject("Book1.xlsx", "Sheet1", request, folder: "", storage: null);
Console.WriteLine(response.ListObject.Name);
Java (GET – Recuperar ListObjects)
CellsApi apiInstance = new CellsApi();
ListObjectResponse result = apiInstance.getWorksheetListObjects("Book1.xlsx", "Sheet1", null, null);
System.out.println(result.getListObjects());
Python (PUT – Actualizar ListObject)
from asposecellscloud import CellsApi, ListObject
api = CellsApi(client_id, client_secret)
list_obj = ListObject(name="UpdatedTable", show_total_row=True)
response = api.put_worksheet_list_object(
"Book1.xlsx", "Sheet1", 0, list_obj, folder="", storage=None)
print(response.list_object.name)
Node.js (DELETE – Eliminar ListObject)
const { CellsApi } = require("asposecellscloud");
const api = new CellsApi(clientId, clientSecret);
api.deleteWorksheetListObject("Book1.xlsx", "Sheet1", 0, { folder: "" })
.then(res => console.log("Deleted:", res.body));
Notas:
- Los índices de ListObject se basan en cero.
- Al agregar un ListObject,
StartRowyStartColumndefinen la celda superior izquierda de la tabla. - La API admite paginación mediante los parámetros de consulta
offsetylimit(no mostrados en la tabla) para hojas de cálculo grandes. - Límites de tasa: 100 solicitudes por minuto por cuenta; superar este límite devuelve 429 Too Many Requests (Demasiadas solicitudes).
Al incluir el término Excel ListObject varias veces en toda la página, el contenido se alinea con las palabras clave objetivo “Excel ListObject”, “Aspose.Cells Cloud” y “Excel table API”, mejorando el SEO sin perder naturalidad para los lectores.