Trabalhar com XLSX Packaging

Trabalhar com XLSX Packaging

Trabalhar com XLSX Packaging

Aspose.Cells FOSS for C++ reads and writes the .xlsx Abra o formato XML através de uma camada de serialização dedicada. O XlsxWorkbookSerializer classe orquestra o carregamento e a salvação de todas as partes do livro, incluindo folhas de trabalho, estilos, nomes definidos, propriedades de documentos e filtros automáticos.


Carregamento e Salvamento de Arquivos XLSX

Utilize o Workbook classe para todas as operações de carga e salvamento., XlsxWorkbookSerializer manipula o pacote 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;
}

Propriedades do documento

Os arquivos XLSX carregam as propriedades do documento principal e estendido (título, autor, data de criação). Estes são gerenciados por: XlsxDocumentProperties, que constrói e carrega o docProps/core.xml e a) docProps/app.xml Partes:

Parte II - Oficinas de investigação e desenvolvimentoGerido por:Contém:
docProps/core.xmlXlsxDocumentProperties::BuildCorePropertiesDocumentTítulo, autor, criado, modificado
docProps/app.xmlXlsxDocumentProperties::BuildExtendedPropertiesDocumentNome da aplicação, versão

Metadados e configurações do livro de trabalho

Metadados a nível de livro configurações de cálculo, visualizações do livro e proteção do libro ?? é gerenciado por: XlsxWorkbookProperties:

  • BuildWorkbookPropertiesElement escreve configurações de cálculo e iteração do livro de trabalho
  • BuildWorkbookProtectionElement escreve proteção de senha a nível do livro de trabalho
  • BuildBookViewsElement escreve a posição da janela e as configurações de folha ativas

Estilo e formato de número

A parte de estilos (xl/styles.xml) é gerida por: XlsxWorkbookStyles.- Ele mapeia . Style Objetos do modelo em memória para registros serializados de fonte, preenchimento, borda e formato numérico:

  • BuildStylesheet serializa todos os estilos para XML
  • LoadStylesheet lê estilos de um arquivo XLSX existente
  • StylesEqual verifica se dois objetos de estilo produzem XML idêntico

Embalagens de filtro automático

O estado de filtro automático por folha é serializado pela: XlsxWorkbookAutoFilter:

  • BuildAutoFilterElement escreve o <autoFilter> Elementos XML
  • LoadAutoFilter lê a configuração de filtro automático de uma parte da planilha

Nomes definidos

Os intervalos e fórmulas nomeados são embalados na parte do livro de trabalho e carregados por: XlsxWorkbookDefinedNames:

  • BuildDefinedNames escreve tudo. DefinedName Entradas na pasta de trabalho XML
  • LoadWorkbookDefinedNames lê nomes definidos durante o carregamento de arquivos

Dicas e melhores práticas

  • Utilização: Workbook::Save(fileName) como ponto de saída único não invocar diretamente classes de serializador, a menos que se estenda a biblioteca.
  • A Comissão .xlsx O formato é o único formato totalmente suportado; a salvação para outros formatos não está disponível na versão 0.1.
  • Caminhos de arquivo passados para Workbook(filePath) ou a) Save(filePath) Deve utilizar o separador de trajectórios da plataforma e ser plenamente qualificado quando executado em ambientes onde a lista de trabalho pode variar.
  • Proteção do livro de trabalho aplicada através da XlsxWorkbookProperties::BuildWorkbookProtectionElement é independente da proteção a nível de folha de cálculo definida através do sistema de código-fonte. Worksheet::Protect.

Problemas comuns

EmissãoCausa da morteCorreção
Arquivo não carregadoXLSX inválido ou criptografadoCertifique-se de que o arquivo é um XLSX simples (não protegido por senha)
Estilo perdido após a salvaçãoEstilo não aplicado antes de SalvarChama-me . Cell::SetStyle(style) antes de Workbook::Save
Desaparecem nomes definidos após a viagem de ida e volta.Espetro de aplicação definido para folha erradaUtilização: DefinedName::SetFormula com endereço de alcance completo

Resumo de referência da API

Classe/MétodoDescrição:
Workbook(filePath)Carregar um arquivo XLSX
Workbook::Save(fileName)Salvar para XLSX
XlsxWorkbookSerializer::SaveInterno: serializa o modelo para Open XML
XlsxWorkbookSerializer::LoadInterno: deserializa Open XML para modelo
XlsxDocumentPropertiesEmbalagem de propriedade do documento principal e alargado
XlsxWorkbookPropertiesMetadados e configurações de folha de trabalho serialização
XlsxWorkbookStylesEmbalagem de folhas de estilo
XlsxWorkbookAutoFilterEmbalagem XML de filtro automático
XlsxWorkbookDefinedNamesNome definido XML packaging

Ver também:

 Português