Visão geral dos recursos

Visão geral dos recursos

Esta página mapeia a superfície de recursos do Aspose.Cells FOSS para Rust. Cada área vincula os tipos de ponto de entrada que você encontrará em API Reference.


Ciclo de vida da pasta de trabalho

Workbook é o objeto raiz: Workbook::new cria uma pasta de trabalho vazia, Workbook::load_xlsx abre um arquivo existente e save, save_xlsx ou save_with_format escrevem a saída XLSX governada pelo enum SaveFormat.

let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;

Células, valores e fórmulas

Coleções de células vêm de get_cells / get_cells_mut em uma planilha. Definidores tipados (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) evitam conversões de string, e put_formula_with_cached_value armazena fórmulas juntamente com seus resultados em cache:

cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
    .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;

Gráficos

Os gráficos são ancorados a intervalos de células por meio da coleção de gráficos de uma planilha com variantes ChartType como Column e Line; âncoras e tipos podem ser lidos de volta de pastas de trabalho carregadas via Chart e ChartCollection.


Estilo e Layout

CellStyle combina Font, Fill e Borders; StyleFlag seleciona quais aspectos se aplicam. NumberFormat renderiza valores, PageSetup controla PaperSizeType e PageOrientationType, e FreezePane fixa linhas de cabeçalho.


Qualidade e Estrutura de Dados

Validation (com OperatorType), formatação condicional FormatCondition, filtragem AutoFilter, tabelas estruturadas ListObject com TableStyleType, intervalos nomeados DefinedName, e WorkbookProtection / WorksheetProtection.


Carregamento Defensivo

LoadOptions expõe as sinalizações try_repair_package e try_repair_xml; LoadDiagnostics relata problemas encontrados durante o carregamento. Erros em toda a superfície do API utilizam Result com CellsError.


Dicas e Melhores Práticas

  • O escopo get_worksheets_mut / get_cells_mut empresta em um bloco para que a pasta de trabalho possa ser salva posteriormente.
  • Prefira setters tipados em vez de formatar valores em strings.
  • Sempre forneça um valor em cache com fórmulas para que os arquivos sejam abertos com resultados corretos antes da recalculação.
  • Use as bandeiras de reparo LoadOptions ao ingerir arquivos de terceiros.

API Reference Resumo

ClasseDescrição
WorkbookObjeto raiz: criar, carregar e salvar livros de trabalho XLSX
WorksheetUma única planilha e suas células, gráficos e configurações
CellMutCélula mutável: definidores de valor tipado e fórmula
CellStyleFormatação de célula com fonte, preenchimento e bordas
ChartTypeSeleção do tipo de gráfico ao adicionar gráficos
ValidationRegras de validação de dados
AutoFilterFiltragem de intervalo
LoadOptionsComportamento de carregamento e flags de reparo
CellsErrorTipo de erro retornado através do API

Ver também

 Português