Aspose.Cells FOSS
.NET
Preguntas frecuentes

Preguntas frecuentes

Preguntas frecuentes

Licencias y código abierto

¿Cuál es la licencia de Aspose.Cells FOSS para .NET?

Aspose.Cells FOSS for .NET se publica bajo la MIT License. Usted es libre de usar, copiar, modificar y distribuir la biblioteca en cualquier proyecto — incluido software comercial — sin regalías ni requisitos de atribución más allá del aviso de licencia. El código fuente está disponible en github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-NET.

¿Puedo usar Aspose.Cells FOSS para .NET en un producto comercial?

Sí. La Licencia MIT permite el uso comercial sin restricciones. No hay límites de usuarios, tarifas de tiempo de ejecución ni requisitos de suscripción.

¿Es esto lo mismo que el Aspose.Cells comercial para .NET?

No. Aspose.Cells FOSS es una biblioteca independiente y separada de código abierto. Solo admite lectura/escritura de XLSX. La versión comercial de Aspose.Cells para .NET admite muchos formatos adicionales (XLS, ODS, PDF, HTML, etc.) y características que están fuera del alcance de esta versión FOSS.

Instalación y Requisitos

¿Cómo instalo Aspose.Cells FOSS para .NET?

Instale mediante la CLI de dotnet:

dotnet add package Aspose.Cells_FOSS

O a través de la consola del Administrador de paquetes de Visual Studio:

Install-Package Aspose.Cells_FOSS

¿Qué versiones de .NET son compatibles?

.NET 6.0 o posterior (.NET 8.0 LTS se recomienda). La biblioteca es código administrado puro y no tiene como objetivo .NET Framework.

¿Hay dependencias nativas?

No. Aspose.Cells FOSS for .NET es código administrado puro sin COM, P/Invoke, Office Interop, ni dependencias de bibliotecas nativas. Se ejecuta en Windows, macOS, Linux, Docker y entornos serverless.

Compatibilidad de formatos

¿Qué formatos de archivo puede leer y escribir Aspose.Cells FOSS para .NET?

FormatoExtensiónLeerEscribir
Xlsx.xlsx✓✓

¿Puede la biblioteca leer o escribir archivos CSV, XLS, ODS o PDF?

No. Sólo XLSX (Open XML) es compatible en esta versión. CSV, XLS binario, ODS, PDF, HTML y la exportación de imágenes no están disponibles.

¿Puedo cargar un archivo XLSX que está ligeramente dañado?

Sí. Pase un objeto LoadOptions con TryRepairPackage = true y TryRepairXml = true al constructor Workbook. La biblioteca intentará recuperar el archivo. Se lanza una WorkbookLoadException si el archivo no se puede recuperar.

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 de API

¿Cómo creo un nuevo libro de trabajo y escribo datos en celdas?

Instanciar Workbook, acceder a la primera hoja de cálculo mediante Workbook.Worksheets[0] y llamar a Cell.PutValue() para escribir datos. Guardar con 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");

¿Cómo leo los valores de celdas de un archivo XLSX existente?

Pase la ruta del archivo al constructor Workbook y lea los valores de celda a través de Cell.StringValue (cadena de visualización) o Cell.Value (objeto .NET sin procesar).

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

¿Cómo aplico estilo a una celda?

Llame Cell.GetStyle() para recuperar el Style actual, modificar las propiedades y llame Cell.SetStyle(style) para aplicarlas.

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");

¿Cómo añado una nueva hoja de cálculo?

Llame a Workbook.Worksheets.Add(name). El método devuelve el índice entero de la nueva hoja; utilícelo para acceder al objeto hoja.

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");

¿Cómo añado validación de datos a un rango de celdas?

Acceda Worksheet.Validations, llame a Add(CellArea) para crear un Validation, luego establezca su 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");

Limitaciones conocidas

¿Qué características no son compatibles?

Los siguientes están fuera del alcance actual de Aspose.Cells FOSS para .NET:

  • Formatos distintos a XLSX (sin XLS, CSV, ODS, PDF, HTML o exportación de imágenes)
  • Tablas dinámicas y gráficos dinámicos
  • Macros VBA
  • Sparklines
  • Texto enriquecido dentro de una sola celda (combinación de estilos de fuente)

¿La biblioteca admite el recálculo de fórmulas?

Las cadenas de fórmulas se almacenan y recuperan literalmente. Los valores calculados se leen del resultado en caché almacenado en el archivo XLSX. La biblioteca no realiza el recálculo de fórmulas en el servidor — la fórmula se recalcula por Excel o una aplicación compatible al abrir.

¿Puedo proteger un libro de trabajo con una contraseña?

La protección a nivel de hoja de cálculo está disponible a través de Worksheet.Protect() y Worksheet.Protection. El cifrado de contraseña a nivel de libro de trabajo no está en la superficie actual de la API.

 Español