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 desenvolvimento | Gerido por: | Contém: |
|---|---|---|
docProps/core.xml | XlsxDocumentProperties::BuildCorePropertiesDocument | Título, autor, criado, modificado |
docProps/app.xml | XlsxDocumentProperties::BuildExtendedPropertiesDocument | Nome 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:
BuildWorkbookPropertiesElementescreve configurações de cálculo e iteração do livro de trabalhoBuildWorkbookProtectionElementescreve proteção de senha a nível do livro de trabalhoBuildBookViewsElementescreve 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:
BuildStylesheetserializa todos os estilos para XMLLoadStylesheetlê estilos de um arquivo XLSX existenteStylesEqualverifica 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:
BuildAutoFilterElementescreve o<autoFilter>Elementos XMLLoadAutoFilterlê 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:
BuildDefinedNamesescreve tudo.DefinedNameEntradas na pasta de trabalho XMLLoadWorkbookDefinedNameslê 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
.xlsxO 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ão | Causa da morte | Correção |
|---|---|---|
| Arquivo não carregado | XLSX inválido ou criptografado | Certifique-se de que o arquivo é um XLSX simples (não protegido por senha) |
| Estilo perdido após a salvação | Estilo não aplicado antes de Salvar | Chama-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 errada | Utilização: DefinedName::SetFormula com endereço de alcance completo |
Resumo de referência da API
| Classe/Método | Descrição: |
|---|---|
Workbook(filePath) | Carregar um arquivo XLSX |
Workbook::Save(fileName) | Salvar para XLSX |
XlsxWorkbookSerializer::Save | Interno: serializa o modelo para Open XML |
XlsxWorkbookSerializer::Load | Interno: deserializa Open XML para modelo |
XlsxDocumentProperties | Embalagem de propriedade do documento principal e alargado |
XlsxWorkbookProperties | Metadados e configurações de folha de trabalho serialização |
XlsxWorkbookStyles | Embalagem de folhas de estilo |
XlsxWorkbookAutoFilter | Embalagem XML de filtro automático |
XlsxWorkbookDefinedNames | Nome definido XML packaging |