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_mutempresta 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
LoadOptionsao ingerir arquivos de terceiros.
API Reference Resumo
| Classe | Descrição |
|---|---|
Workbook | Objeto raiz: criar, carregar e salvar livros de trabalho XLSX |
Worksheet | Uma única planilha e suas células, gráficos e configurações |
CellMut | Célula mutável: definidores de valor tipado e fórmula |
CellStyle | Formatação de célula com fonte, preenchimento e bordas |
ChartType | Seleção do tipo de gráfico ao adicionar gráficos |
Validation | Regras de validação de dados |
AutoFilter | Filtragem de intervalo |
LoadOptions | Comportamento de carregamento e flags de reparo |
CellsError | Tipo de erro retornado através do API |