Trabajar con el paquete XLSX
Trabajar con el paquete XLSX
Aspose.Cells FOSS for C++ reads and writes the .xlsx Formato XML abierto a través de una capa de serializacin dedicada. XlsxWorkbookSerializer Orquesta de clase carga y salva todas las partes del libro de trabajo incluyendo hojas, estilos, nombres definidos, propiedades de documento y filtros automáticos.
Cargar y ahorrar archivos XLSX
Utilice el Workbook clase para todas las cargas y operaciones de ahorro. internamente, XlsxWorkbookSerializer El código de Open XML:
#include "aspose/cells_foss/Workbook.h"
using namespace Aspose::Cells_FOSS;
int main() {
// Load existing XLSX
Workbook workbook("input.xlsx");
// Modify content...
// Save back to XLSX
workbook.Save("output.xlsx");
return 0;
}Propiedades del documento
Los archivos XLSX carecen de propiedades básicas y extendidas del documento (título, autor, fecha de creación). XlsxDocumentProperties,que construye y carga el docProps/core.xml y docProps/app.xml Las partes:
| parte | Gestionado por | contenidos |
|---|---|---|
docProps/core.xml | XlsxDocumentProperties::BuildCorePropertiesDocument | Título, autor, creado y modificado |
docProps/app.xml | XlsxDocumentProperties::BuildExtendedPropertiesDocument | Nombre de la aplicación, versión |
Metadatos y configuraciones de Workbook
Los metadatos de nivel del libro de trabajo —estaciones de cálculo, vistas de libros y protección del libro de obra— se manejan por el XlsxWorkbookProperties:
BuildWorkbookPropertiesElement- Escribe las configuraciones de cálculo y iteración del libro de trabajoBuildWorkbookProtectionElement- Escribe protección de contraseñas en el nivel del libro de trabajoBuildBookViewsElement- Escribe la posición de ventana y las configuraciones de hoja activa
Estilos y formatos de números
El estilo de la parte (xl/styles.xmlSe gestiona por XlsxWorkbookStyles.El mapa Style Objetos del modelo en memoria a los registros de letra, relleno, límite y formato número serializados:
BuildStylesheet- Se clasifica todos los estilos en XMLLoadStylesheet- Lida los estilos de un archivo XLSX existente.StylesEqual- verificar si dos objetos de estilo producirían XML idénticos.
Empaquetado de automóviles filtrados
El estado de auto-filter por hoja de trabajo se serializará por XlsxWorkbookAutoFilter:
BuildAutoFilterElement- Escribe el<autoFilter>Elementos XMLLoadAutoFilter- Lida la configuración de filtros automáticos desde una parte del panel de trabajo
Nombres definidos
Las ramas y fórmulas nombradas se envasan en la parte del libro de trabajo y cargan por XlsxWorkbookDefinedNames:
BuildDefinedNamesEscribe todoDefinedNameEnlaces al libro de trabajo XMLLoadWorkbookDefinedNames-Ler los nombres definidos durante el cargamento de archivos
Consejos y mejores prácticas
- Uso
Workbook::Save(fileName)como el único punto de salida — no invocar clases serializadores directamente a menos que se extiende la biblioteca. - El
.xlsxEl formato es el único formato totalmente soportado; el almacenamiento de otros formatos no está disponible en v0.1. - Los archivos pasados a
Workbook(filePath)oSave(filePath)debe utilizar el separador de ruta de la plataforma y estar totalmente cualificado al correr en entornos donde el directorio de trabajo puede variar. - Protección del libro de trabajo aplicada a través de
XlsxWorkbookProperties::BuildWorkbookProtectionElementes independiente de la protección del nivel de trabajo establecida por elWorksheet::Protect.
Problemas comunes
| Problemas | Causas | Fixado |
|---|---|---|
| El archivo no se carga | Invalido o cifrado XLSX | Asegúrese de que el archivo es un plano (no protegido por contraseña) XLSX |
| Los estilos perdidos después de salvarse | Estilo no aplicado antes de salvar | llamadas Cell::SetStyle(style) Antes de Workbook::Save |
| Nombres que se quedan tras el viaje de vuelta | Lugar de la hoja equivocada | Uso DefinedName::SetFormula con dirección de gama completa |
Sumación de referencia API
| Clase / Método | Descripción |
|---|---|
Workbook(filePath) | Cargar un archivo XLSX |
Workbook::Save(fileName) | Salva a XLSX |
XlsxWorkbookSerializer::Save | Internal: se serializará el modelo a Open XML |
XlsxWorkbookSerializer::Load | Internal: deserializará Open XML a modelo |
XlsxDocumentProperties | Empaquetado de propiedad básica y extendida del documento |
XlsxWorkbookProperties | Metadatos de libro de trabajo y serializacin de configuraciones |
XlsxWorkbookStyles | Estilo de paquete |
XlsxWorkbookAutoFilter | El paquete de filtros XML |
XlsxWorkbookDefinedNames | Nombre definido de XML Packaging |