Como trabalhar com as configurações do livro de trabalho básico em .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (sistema de data e local), Workbook.DocumentProperties (metadados do autor), Workbook.LoadDiagnostics (relatório de reparação) e SaveOptions Instalar com: dotnet add package Aspose.Cells_FOSS.

Guia passo a passo

Passo 1: Instalar o pacote

dotnet add package Aspose.Cells_FOSS

Passo 2: Importar o espaço de nomes

using Aspose.Cells_FOSS;
using System.Globalization;

Passo 3: Configurar configurações do livro de trabalho

Workbook.Settings retorna um WorkbookSettings Objeto. Date1904 = true para arquivos de origem macOS que usam o sistema de data 1904. Set Culture para controlar o número e a data de análise 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);

Passo 4: Configurar propriedades do documento

Workbook.DocumentProperties exposições Title, Subject, Author, Keywords, Comments, Category, Company, e Manager como propriedades de cadeias diretas.

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

Passo 5: Use SaveOptions

Workbook.Save(path, SaveOptions) aceita um SaveOptions Objeto para personalizar a saída.: UseSharedStrings (reduz o tamanho do ficheiro para folhas com cadeias repetidas), ValidateBeforeSave (executa a validação antes da escrita), e CompactStyles (elimina estilos não 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.");

Passo 6: Leia o diagnóstico de carga após a reparação

Após a carga com: TryRepairPackage = true, verifique Workbook.LoadDiagnostics para ver se foram aplicados reparos.

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 comuns e soluções

WorkbookSaveException quando? ValidateBeforeSave = true. O livro contém uma inconsistência estrutural. Desativar ValidateBeforeSave temporariamente para salvar e inspecionar o ficheiro, em seguida corrigir o conteúdo problemático.

Propriedades de documento não visíveis no painel Informações sobre arquivo do Excel. Certifique-se de que está a definir propriedades em Workbook.DocumentProperties, não . Workbook.Properties.Este último contém sinais de exibição, não cadeias de metadados.

Date1904 = true causa a mudança dos valores da data. Date1904 altera a época usada para números de série da data. Apenas configure-a como true para arquivos que são originários do macOS Excel com o sistema de data 1904 habilitado; os sistemas de misturação causam erros fora dos 1462 dias.

Perguntas Frequentes

Qual é a diferença entre: `WorkbookSettings` e a) `WorkbookProperties`?

WorkbookSettings (através da Workbook.Settings) contém valores de configuração como: Date1904 e a) Culture. WorkbookProperties (através da Workbook.Properties) contém sinais de exibição OOXML tais como: ShowObjects.As cadeias de metadados do documento (título, autor etc.) estão presentes no Workbook.DocumentProperties.

- Sim . `CompactStyles` Nunca remover estilos que eu preciso?

Não, não. CompactStyles Remove apenas os estilos que não são referenciados por nenhuma célula ou regra de formato na pasta de trabalho.

Posso ler? `LoadDiagnostics` mesmo quando não houve tentativa de reparação?

Sim, o… Issues coleção será vazia e ambos HasRepairs e a) HasDataLossRisk voltará . false.