1. Produtos
  2.   Aspose.Cells
  3.   Aspose.Cells FOSS for .NET

Aspose.Cells FOSS for .NET

Crie, modifique e salve pastas de trabalho Excel .xlsx a partir do .NET livre e open-source, sem dependência do Microsoft Office.

Aspose.Cells FOSS for .NET Aspose.Cells FOSS
for .NET

Documentação GitHub

Biblioteca .NET de código aberto para planilhas do Excel

Aspose.Cells FOSS para .NET é uma biblioteca de código aberto gratuita, licenciada pelo MIT para trabalhar com arquivos de planilha do Excel em aplicativos do .Net. Instale-o com um único comando dotnet add package Aspose.Cells_FOSS e comece a criar livros de trabalho, ler células, aplicar estilos, adicionar formatação condicional, hiperlinks, validação de dados e filtros automáticos tudo sem exigir o Microsoft Excel ou qualquer biblioteca nativa do Office.

A biblioteca expõe uma API limpa construída em torno de Workbook, Worksheet , Cells e Cell os objetos familiares que todo desenvolvedor de planilha conhece. Construa um Workbook para carregar um arquivo existente .xlsx ou crie um branco, acesse folhas de trabalho através da coleção Worksheets . Leia e escreva valores de células com PutValue e aplique estilos via GetStyle() /SetStyle(). As fórmulas são armazenadas como cadeias e avaliadas pelo visualizador no aberto, não pela biblioteca durante o tempo de execução.

Como a biblioteca é puro gerenciado código .NET sem dependências nativas, ele funciona de forma idêntica no Windows, macOS, Linux, contêineres Docker e ambientes sem servidor como Azure Functions e AWS Lambda. Para capacidades mais avançadas, considere o Aspose.Cells commercial edition. A Licença MIT permite uso comercial ilimitado sem royalties, licenças de assento ou taxas por implantação.

Leia e Escreva Arquivos do Excel

  • XLSX read/write: Abra e guarde livros de trabalho com fidelidade completa em viagem redonda usando Workbook(fileName) e Save(fileName).
  • ** Valores de célula:** Escreva os valores string, int , bool e decimal com Cell.PutValue(value).
  • ** Acesso à célula:** Leia valores com Cell.StringValue e Cell.Value.
  • Formulas: Armazene as cadeias de fórmulos através do Cell.Formula avaliadas pelo Excel em aberto.
  • ** Navegação da folha de trabalho:** Acesso às folhas por índice ou nome através do Workbook.Worksheets.

Onde Aspose.Cells FOSS para .NET pode ser usado

  • Geração de relatórios: Criar relatorios Excel marcados em aplicações do servidor .NET.
  • Exportação de dados: Escrever os resultados da consulta do banco de Dados diretamente para .xlsx sem Office.
  • Automatização CI/CD: Gerar livros de resultados de testes dentro do Docker ou Linux CI.
  • ** Fluxos de trabalho ETL:** Ler folhas de entrada, transformar dados e escrever livros de saída.
  • ** Funções sem servidor:** Execute dentro do Azure Functions ou AWS Lambda sem dependências.

Estilização de células e formatação condicional

  • ** Estilo de fonte:** Aplicar negrito, itálico, tamanho da fonte e cor através Style.Font.
  • ** Padrões de preenchimento:** Defina cores de fundo com Style.ForegroundColor e FillPattern.Solid.
  • ** Formato condicional:** Adicionar FormatConditionType.CellValue, Expression , ColorScale e DataBar através de regras Worksheet.ConditionalFormattings.
  • Formados de número: Atribuir cadeias personalizadas de formato de números por célula.

Formatação de casos de uso

  • ** Relatórios do painel:** Aplicar escalas de cores e barras de dados para realçar os intervalos KPI.
  • Folhas de status: Utilize conjuntos de ícones para categorizar visualmente os estados das linhas.
  • ** Livros de trabalho financeiros:** Formatar as colunas de moeda e data com formatos numéricos integrados.
  • Ao estilo de cabeçalho: As linhas de cabeça em negrito e cor para distinguir-as das linhagens de dados.

Validação de dados e filtros automáticos

  • ** Regras de validação:** Adicionar a validações por número inteiro, decimal, lista e data através do ValidationCollection.Add().
  • ** Operadores:** Use OperatorType.Between, GreaterThan e outros.
  • ** Tipo de validação:** Defina ValidationType.WholeNumber, Decimal , List,Date ou Custom.
  • Filtros automáticos: Aplicar filtros de coluna num intervalo com AutoFilter e AutoFilter.FilterColumns.
  • ** Áreas de célula:** Defina os intervalos de validação usando CellArea.CreateCellArea(start, end).

Casos de utilização da validação

  • Formulários de entrada de dados: Restringir a entrada aos intervalos válidos antes da partilha do livro.
  • Modelos de orçamento: Aplicar as células do orçmento com o número inteiro e os limites mínimos/máximos.
  • Pilhas de comunicação: Validar os dados de saída antes da entrega aos interessados.
  • ** Restrições de lista:** Bloquear células numa lista suspensa pré-definida de valores permitidos.

Hiperlinks, Áreas de Nome e Proteção

  • Hyperlinks: Adicionar URLs externos, referências internas de células e links para mailto via HyperlinkCollection.Add().
  • ** Intervalos nomeados:** Defina os intervalos de nomes globais e por folha com DefinedNameCollection.Add().
  • Proteção do livro de trabalho: Bloqueie a estrutura do libro de trabalhos usando WorkbookProtection.
  • Proteção da folha de trabalho: Proteja as folhas individuais com Worksheet.Protect().
  • ** Diagnóstico de carga:** Inspeccionar a entrada malformada usando LoadDiagnostics e LoadIssue.

Governança e casos de uso da colaboração

  • ** Distribuição do modelo:** Protegam as folhas para evitar a sobreposição acidental da fórmula.
  • Cartas de trabalho partilhadas: Utilize intervalos nomeados para criar referências estabilizadas em folhas cruzadas.
  • Rotas de auditoria: Liga células a URLs de documentação externa através de hiperlinks.
  • Validação de entrada: Combinar proteção e validação para aplicar a governança dos dados.

Crie um livro de trabalho e escreva células

Instale o pacote NuGet, depois crie um Workbook, acesse o primeiro Worksheet e escreva valores em células usando PutValue. O exemplo demonstra a escrita de vários tipos de valor e executando uma volta-e-volta com armazenamento.

dotnet add package Aspose.Cells_FOSS

using Aspose.Cells_FOSS;

var outputPath = "cell-data-roundtrip.xlsx";
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].PutValue(true);
sheet.Cells["D1"].PutValue(12.5m);
sheet.Cells["F1"].PutValue(10);
sheet.Cells["G1"].Formula = "=F1*2";
workbook.Save(outputPath);

var loaded = new Workbook(outputPath);
var loadedSheet = loaded.Worksheets[0];
Console.WriteLine(loadedSheet.Cells["A1"].StringValue);
Console.WriteLine(loadedSheet.Cells["G1"].Formula);

Aplicar formatação condicional

Adicionar regras de formatação condicional para destacar intervalos de células. O exemplo aplica uma regra entre valores com um preenchimento sólido, uma regla de expressão, um escala de cores, a barra de dados e um conjunto de ícones.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Conditional Formatting";

for (var i = 0; i < 10; i++)
    sheet.Cells[i, 0].PutValue(i + 1);

var cfCol = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCol.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCol[cfCol.AddCondition(FormatConditionType.CellValue,
    OperatorType.Between, "3", "7")];
var style = rule.Style;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
style.Font.Bold = true;
rule.Style = style;

workbook.Save("conditional-formatting.xlsx");

Adicionar hiperlinks e rangos nomeados

Criar hiperlinks externos e internos, em seguida definir intervalos nomeados com escopo para o livro de trabalho ou uma folha específica.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Links";

sheet.Cells["A1"].PutValue("Docs");
var link = sheet.Hyperlinks[sheet.Hyperlinks.Add("A1", 1, 1, "https://example.com/docs")];
link.TextToDisplay = "Docs";
link.ScreenTip = "External docs";

var name = workbook.DefinedNames[workbook.DefinedNames.Add("GlobalRange", "='Links'!$A$1:$D$5")];
name.Comment = "Primary sample range";

workbook.Save("hyperlinks-and-names.xlsx");

Perguntas Frequentes

O que é Aspose.Cells FOSS para .NET?

É uma biblioteca .NET de código aberto gratuita, licenciada pelo MIT para criar, ler, modificar e salvar quadros de trabalho Excel .xlsx sem exigir o Microsoft Office.

Quais formatos de arquivo são suportados?

.xlsx é o único formato de leitura/escrita suportado. .xls, .csv , .ods,.pdf e .html não estão disponíveis nesta edição.

Requer o Microsoft Office?

Não. Aspose.Cells FOSS é código .NET puro gerenciado sem COM, P/Invoke, Office Interop ou dependências de biblioteca nativas.

Como é que o instalo?

Execute dotnet add package Aspose.Cells_FOSS. A biblioteca requer .NET 6.0 ou posterior. Não há extensões nativas para compilar.

A biblioteca suporta a fórmula de recalculação?

As cadeias de fórmulas são armazenadas e recuperadas literalmente. A biblioteca não realiza recalculação do lado do servidor as fórmulas são avaliadas pelo Excel ou por um aplicativo compatível no open.

Posso usá-lo num produto comercial?

Sim, a licença MIT permite uso comercial ilimitado sem royalties, licenças de assento ou taxas por implantação.

  

Recursos de Suporte e Aprendizado

 Português