Trabajar con el paquete XLSX

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:

parteGestionado porcontenidos
docProps/core.xmlXlsxDocumentProperties::BuildCorePropertiesDocumentTítulo, autor, creado y modificado
docProps/app.xmlXlsxDocumentProperties::BuildExtendedPropertiesDocumentNombre 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 trabajo
  • BuildWorkbookProtectionElement - Escribe protección de contraseñas en el nivel del libro de trabajo
  • BuildBookViewsElement - 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 XML
  • LoadStylesheet - 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 XML
  • LoadAutoFilter - 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:

  • BuildDefinedNames Escribe todo DefinedName Enlaces al libro de trabajo XML
  • LoadWorkbookDefinedNames -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 .xlsx El formato es el único formato totalmente soportado; el almacenamiento de otros formatos no está disponible en v0.1.
  • Los archivos pasados a Workbook(filePath) o Save(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::BuildWorkbookProtectionElement es independiente de la protección del nivel de trabajo establecida por el Worksheet::Protect.

Problemas comunes

ProblemasCausasFixado
El archivo no se cargaInvalido o cifrado XLSXAsegúrese de que el archivo es un plano (no protegido por contraseña) XLSX
Los estilos perdidos después de salvarseEstilo no aplicado antes de salvarllamadas Cell::SetStyle(style) Antes de Workbook::Save
Nombres que se quedan tras el viaje de vueltaLugar de la hoja equivocadaUso DefinedName::SetFormula con dirección de gama completa

Sumación de referencia API

Clase / MétodoDescripción
Workbook(filePath)Cargar un archivo XLSX
Workbook::Save(fileName)Salva a XLSX
XlsxWorkbookSerializer::SaveInternal: se serializará el modelo a Open XML
XlsxWorkbookSerializer::LoadInternal: deserializará Open XML a modelo
XlsxDocumentPropertiesEmpaquetado de propiedad básica y extendida del documento
XlsxWorkbookPropertiesMetadatos de libro de trabajo y serializacin de configuraciones
XlsxWorkbookStylesEstilo de paquete
XlsxWorkbookAutoFilterEl paquete de filtros XML
XlsxWorkbookDefinedNamesNombre definido de XML Packaging

Ver también

 Español