Aspose.Cells Software Livre e de Código Aberto
.NET
Perguntas Frequentes

Perguntas Frequentes

Perguntas Frequentes

Licenciamento & Código Aberto

Qual é a licença do Aspose.Cells FOSS para .NET?

Aspose.Cells FOSS for .NET é publicado sob a MIT License. Você tem liberdade para usar, copiar, modificar e distribuir a biblioteca em qualquer projeto — incluindo software comercial — sem royalties ou exigências de atribuição além do aviso de licença. O código‑fonte está disponível em github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-NET.

Posso usar o Aspose.Cells FOSS para .NET em um produto comercial?

Sim. A Licença MIT permite uso comercial irrestrito. Não há limites de assentos, taxas de tempo de execução ou requisitos de assinatura.

Isso é o mesmo que o Aspose.Cells comercial para .NET?

Não. Aspose.Cells FOSS é uma biblioteca separada e independente de código aberto. Ela suporta apenas leitura/gravação de XLSX. O Aspose.Cells comercial para .NET suporta muitos formatos adicionais (XLS, ODS, PDF, HTML, etc.) e recursos que estão fora do escopo desta versão FOSS.

Instalação e Requisitos

Como instalo o Aspose.Cells FOSS para .NET?

Instale via a CLI do dotnet:

dotnet add package Aspose.Cells_FOSS

Ou através do Console do Gerenciador de Pacotes do Visual Studio:

Install-Package Aspose.Cells_FOSS

Quais versões do .NET são suportadas?

.NET 6.0 ou posterior (.NET 8.0 LTS é recomendado). A biblioteca é código gerenciado puro e não tem como alvo o .NET Framework.

Existem dependências nativas?

Não. Aspose.Cells FOSS for .NET é código gerenciado puro sem COM, P/Invoke, Office Interop ou dependências de bibliotecas nativas. Ele funciona no Windows, macOS, Linux, Docker e ambientes sem servidor.

Suporte a Formatos

Quais formatos de arquivo o Aspose.Cells FOSS para .NET pode ler e gravar?

FormatoExtensãoLerGravar
Xlsx.xlsx✓✓

A biblioteca pode ler ou gravar arquivos CSV, XLS, ODS ou PDF?

Não. Apenas XLSX (Open XML) é suportado nesta versão. CSV, XLS binário, ODS, PDF, HTML e exportação de imagem não estão disponíveis.

Posso carregar um arquivo XLSX que está ligeiramente corrompido?

Sim. Passe um objeto LoadOptions com TryRepairPackage = true e TryRepairXml = true para o construtor Workbook. A biblioteca tentará recuperar o arquivo. Um WorkbookLoadException é lançado se o arquivo for irrecuperável.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
Console.WriteLine("Repairs applied: " + wb.LoadDiagnostics.HasRepairs);

Uso da API

Como criar uma nova pasta de trabalho e escrever dados nas células?

Instancie Workbook, acesse a primeira planilha via Workbook.Worksheets[0] e chame Cell.PutValue() para gravar os dados. Salve com Workbook.Save(path).

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells["A1"].PutValue("Name");
ws.Cells["B1"].PutValue("Score");
ws.Cells["A2"].PutValue("Alice");
ws.Cells["B2"].PutValue(95);
ws.Cells["C2"].Formula = "=B2*1.1";

wb.Save("output.xlsx");

Como leio valores de células de um arquivo XLSX existente?

Passe o caminho do arquivo para o construtor Workbook e leia os valores das células através de Cell.StringValue (string de exibição) ou Cell.Value (objeto .NET bruto).

using Aspose.Cells_FOSS;

var wb = new Workbook("output.xlsx");
var ws = wb.Worksheets[0];

Console.WriteLine(ws.Cells["A2"].StringValue);  // Alice
Console.WriteLine(ws.Cells["B2"].StringValue);  // 95
Console.WriteLine(ws.Cells["C2"].Formula);       // =B2*1.1

Como aplico estilo a uma célula?

Chame Cell.GetStyle() para recuperar o Style atual, modificar propriedades e chamar Cell.SetStyle(style) para aplicá‑las.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var cell = wb.Worksheets[0].Cells["A1"];
cell.PutValue("Header");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Font.Size = 14;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = System.Drawing.Color.FromArgb(255, 198, 239, 206);
style.HorizontalAlignment = HorizontalAlignmentType.Center;
cell.SetStyle(style);

wb.Save("styled.xlsx");

Como adiciono uma nova planilha?

Chame Workbook.Worksheets.Add(name). O método retorna o índice inteiro da nova planilha; use‑o para acessar o objeto da planilha.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.Worksheets[0].Name = "Summary";
var dataIdx = wb.Worksheets.Add("Data");
wb.Worksheets[dataIdx].Cells["A1"].PutValue("Data sheet");
wb.Save("multi.xlsx");

Como adiciono validação de dados a um intervalo de células?

Acesse Worksheet.Validations, chame Add(CellArea) para criar um Validation, então defina seu Type usando ValidationType.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

var val = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
val.Type = ValidationType.List;
val.Formula1 = "\"Open,Closed,Pending\"";
val.InCellDropDown = true;

wb.Save("validated.xlsx");

Limitações Conhecidas

Quais recursos não são suportados?

Os seguintes estão fora do escopo atual do Aspose.Cells FOSS para .NET:

  • Formatos diferentes de XLSX (sem XLS, CSV, ODS, PDF, HTML ou exportação de imagem)
  • Tabelas dinâmicas e gráficos dinâmicos
  • Macros VBA
  • Sparklines
  • Texto rico dentro de uma única célula (mistura de estilos de fonte)

A biblioteca suporta recalculação de fórmulas?

As strings de fórmula são armazenadas e recuperadas literalmente. Os valores calculados são lidos do resultado em cache armazenado no arquivo XLSX. A biblioteca não realiza recalculação de fórmulas no lado do servidor — a fórmula é recalculada pelo Excel ou por um aplicativo compatível ao abrir.

Posso proteger uma pasta de trabalho com uma senha?

A proteção ao nível da planilha está disponível através de Worksheet.Protect() e Worksheet.Protection. A criptografia por senha ao nível da pasta de trabalho não está na superfície atual da API.

 Português