Cómo trabajar con las configuraciones de libro de trabajo básico en .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (Sistema de fecha y localidad), Workbook.DocumentProperties (El autor de los datos metabólicos), Workbook.LoadDiagnostics (el informe de reparación) y SaveOptions (Save behavior) Instalar con dotnet add package Aspose.Cells_FOSS.

Guía paso a paso

Paso 1: Instalar el paquete

dotnet add package Aspose.Cells_FOSS

Paso 2: Importación del espacio de nombre

using Aspose.Cells_FOSS;
using System.Globalization;

Paso 3: Configure WorkbookSettings

Workbook.Settings Volver a WorkbookSettings Objeto: Sitio Date1904 = true para archivos originados en macOS que utilicen el sistema de fecha 1904. Culture para controlar el número y la fecha de parsón local.

using Aspose.Cells_FOSS;
using System.Globalization;

var wb = new Workbook();
wb.Settings.Date1904 = false;
wb.Settings.Culture = new CultureInfo("en-US");
wb.Worksheets[0].Cells["A1"].PutValue("Settings configured");
wb.Save("settings.xlsx");

var loaded = new Workbook("settings.xlsx");
Console.WriteLine("Date1904: " + loaded.Settings.Date1904);

Paso 4: Configurar las propiedades de los documentos

Workbook.DocumentProperties Exposiciones Title, Subject, Author, Keywords, Comments, Category, Company,y, Manager como propiedades de la línea directa.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.DocumentProperties.Title = "Quarterly Report";
wb.DocumentProperties.Author = "Reporting Team";
wb.DocumentProperties.Company = "Contoso Ltd";
wb.DocumentProperties.Keywords = "quarterly, sales, 2026";
wb.Save("properties.xlsx");

var loaded = new Workbook("properties.xlsx");
Console.WriteLine("Title: " + loaded.DocumentProperties.Title);
Console.WriteLine("Author: " + loaded.DocumentProperties.Author);

Paso 5: Use SaveOptions

Workbook.Save(path, SaveOptions) acepta a SaveOptions para la realización de las actividades. propiedades clave: UseSharedStrings (reducir el tamaño de archivo para las hojas con líneas repetidas), ValidateBeforeSave (seguir la valoración antes de escribir) y CompactStyles (Elimina los estilos no utilizados).

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];
for (var i = 0; i < 50; i++)
    ws.Cells[i, 0].PutValue("Repeated text");

var opts = new SaveOptions
{
    UseSharedStrings = true,
    ValidateBeforeSave = true,
    CompactStyles = true,
};

wb.Save("compact.xlsx", opts);
Console.WriteLine("Saved with SaveOptions.");

Paso 6: Leer Diagnóstico de carga después de la reparación

Después de cargar con TryRepairPackage = true,El cheque Workbook.LoadDiagnostics Ver si se realizan reparaciones.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
var diag = wb.LoadDiagnostics;

Console.WriteLine("HasRepairs: " + diag.HasRepairs);
Console.WriteLine("HasDataLossRisk: " + diag.HasDataLossRisk);
foreach (var entry in diag.Issues)
    Console.WriteLine($"  [{entry.Severity}] {entry.Code}: {entry.Message}");

Problemas y soluciones comunes

WorkbookSaveException Cuando ValidateBeforeSave = true. El libro contiene una inconsistencia estructural. ValidateBeforeSave para guardar y inspeccionar temporalmente el archivo, luego corregir el contenido problemático.

Propiedades de documento no se ven en el panel de información de archivos de Excel. Asegúrese de que está configurando propiedades en Workbook.DocumentProperties,No no Workbook.Properties.El último tiene banderas de pantalla, no líneas de metadatos.

Date1904 = true que los valores de la fecha cambian. Date1904 cambia la época utilizada para los números de serie de fecha. true para los archivos que se originan en macOS Excel con el sistema de fecha 1904 activado; los sistemas de mezcla causan errores de día a día.

Preguntas frecuentes

¿Cuál es la diferencia entre `WorkbookSettings` y `WorkbookProperties`?

WorkbookSettings (Vía de Workbook.Settings• Contiene valores de configuración como Date1904 y Culture. WorkbookProperties (Vía de Workbook.Properties• Tiene una bandera de pantalla OOXML como: ShowObjects.Las líneas de metadatos de documentos (Título, Autor, etc.) en vivo en el Workbook.DocumentProperties.

¿Qué hace `CompactStyles` ¿Alguna vez se quitan los estilos que necesito?

No no. CompactStyles Sólo elimina los estilos que no se refieren por ninguna regla de célula o formato en el libro de trabajo.

Puedo leer `LoadDiagnostics` ¿Aún cuando no se trató de reparación?

Sí, el Issues La colección estará vacía y ambos HasRepairs y HasDataLossRisk volverá false.