Cum să lucrați cu setările de bază ale cărții de lucru în .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (sistem de date și locuri), Workbook.DocumentProperties (metadatele despre autor), Workbook.LoadDiagnostics (raport de reparație) și SaveOptions (înregistrarea comportamentului). dotnet add package Aspose.Cells_FOSS.

Ghid pas cu pas

Pasul 1: Instalați pachetul

dotnet add package Aspose.Cells_FOSS

Pasul 2: Importarea spațiului de nume

using Aspose.Cells_FOSS;
using System.Globalization;

Pasul 3: Configurați Setările cărții de lucru

Workbook.Settings returnează un WorkbookSettings Obiectul. Date1904 = true pentru fișierele originare din macOS care folosesc sistemul de date 1904. Set Culture pentru a controla numărul şi data local de analizare.

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

Pasul 4: Setarea proprietăților documentului

Workbook.DocumentProperties expuneri Title, Subject, Author, Keywords, Comments, Category, Company, și Manager ca proprietăți de șir direct.

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

Pasul 5: Folosiţi SaveOptions

Workbook.Save(path, SaveOptions) acceptă o SaveOptions Obiectivul de a personaliza rezultatul. Proprietăți cheie: UseSharedStrings (reducă dimensiunea fișierului pentru foi cu șiruri repetate), ValidateBeforeSave (vâldificarea înainte de scriere), și CompactStyles (scapă de stiluri neutilizate).

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

Pasul 6: Citeste diagnosticarea sarcinii dupa reparatie

După încărcare cu: TryRepairPackage = true, verificare Workbook.LoadDiagnostics să vadă dacă au fost efectuate reparaţii.

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

Probleme comune şi soluţii

WorkbookSaveException când … ValidateBeforeSave = true. Cartea de lucru conține o neconcordanță structurală. dezactivați ValidateBeforeSave temporar pentru a salva și inspecta fișierul, apoi să repare conținutul problematic.

Proprietățile documentului nu sunt vizibile în panoul Informații despre fișiere din Excel. Asigură-te că ai stabilit proprietăţile pe Workbook.DocumentProperties, nu . Workbook.Properties.Ultima conține steaguri de afișare, nu șiruri metadate.

Date1904 = true face ca valorile de data sa se mute. Date1904 schimbă epoca folosită pentru numerele de serie date. Doar setat la true pentru fișierele care provin din macOS Excel cu sistemul de date 1904 activat; sisteme de amestecare provoacă erori în afara zilei 1462.

Întrebări frecvente

Care este diferenţa între: `WorkbookSettings` și de: `WorkbookProperties`?

WorkbookSettings (prin intermediul Workbook.Settings) conține valori de configurare precum: Date1904 și de: Culture. WorkbookProperties (prin intermediul Workbook.Properties) conține steaguri de afișare OOXML, cum ar fi: ShowObjects.Strângerile de metadate ale documentului (titlu, autor etc.) sunt prezentate în Workbook.DocumentProperties.

- Da. Nu, nu e aşa. `CompactStyles` Am mai scos stilurile de care am nevoie?

Nu, nu. Ce?. CompactStyles elimină doar stilurile care nu sunt referite de nicio celulă sau regulă de format din cartea de lucru.

Pot să citesc ? `LoadDiagnostics` Chiar dacă nu s-a încercat repararea?

Da, în… Issues colectia va fi goala si ambele HasRepairs și de: HasDataLossRisk se va întoarce . false.