Kako raditi s osnovnim postavkama radne knjige u .NET-u
Aspose.Cells FOSS for .NET izlaže konfiguraciju na razini radne knjige putem Workbook.Settings (lokal i sustav datuma), Workbook.DocumentProperties (metapodaci autora), Workbook.LoadDiagnostics (izvješće o popravku) i SaveOptions (ponašanje spremanja). Instalirajte pomoću dotnet add package Aspose.Cells_FOSS.
Vodič korak po korak
Korak 1: Instalirajte paket
dotnet add package Aspose.Cells_FOSSKorak 2: Uvezi prostor imena
using Aspose.Cells_FOSS;
using System.Globalization;Korak 3: Konfiguriraj WorkbookSettings
Workbook.Settings vraća WorkbookSettings objekt. Postavite Date1904 = true za datoteke nastale na macOS-u koje koriste 1904 sustav datuma. Postavite Culture za kontrolu lokalizacije parsiranja brojeva i datuma.
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);Korak 4: Postavi svojstva dokumenta
Workbook.DocumentProperties izlaže Title, Subject, Author, Keywords, Comments, Category, Company i Manager kao izravna svojstva tipa string.
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);Korak 5: Upotrijebite SaveOptions
Workbook.Save(path, SaveOptions) prihvaća SaveOptions objekt za prilagodbu izlaza. Ključna svojstva: UseSharedStrings (smanjuje veličinu datoteke za listove s ponovljenim nizovima), ValidateBeforeSave (izvršava provjeru valjanosti prije pisanja) i CompactStyles (uklanja neiskorištene stilove).
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.");Korak 6: Pročitaj LoadDiagnostics nakon popravka
Nakon učitavanja s TryRepairPackage = true, provjerite Workbook.LoadDiagnostics kako biste vidjeli jesu li primijenjene ikakve popravke.
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}");Uobičajeni problemi i rješenja
WorkbookSaveException kada ValidateBeforeSave = true.
Radna knjiga sadrži strukturnu nedosljednost. Privremeno onemogućite ValidateBeforeSave da biste spremili i pregledali datoteku, zatim ispravite problematični sadržaj.
Svojstva dokumenta nisu vidljiva u Excelovom panelu Informacije o datoteci.
Provjerite da postavljate svojstva na Workbook.DocumentProperties, a ne na Workbook.Properties. Posljednji sadrži zastavice prikaza, a ne meta‑podatkovne nizove.
Date1904 = true uzrokuje pomak vrijednosti datuma.
Date1904 mijenja epohu koja se koristi za serijske brojeve datuma. Postavite ga na true samo za datoteke koje su nastale u macOS Excelu s omogućenim 1904 sustavom datuma; miješanje sustava uzrokuje pogreške od 1462 dana.
Često postavljana pitanja
Koja je razlika između WorkbookSettings i WorkbookProperties?
WorkbookSettings (preko Workbook.Settings) sadrži konfiguracijske vrijednosti poput Date1904 i Culture. WorkbookProperties (preko Workbook.Properties) sadrži OOXML prikazne zastavice poput ShowObjects. Nizovi metapodataka dokumenta (Naslov, Autor, itd.) nalaze se u Workbook.DocumentProperties.
Da li CompactStyles ikada uklanja stilove koje trebam?
Ne. CompactStyles uklanja samo stilove koji nisu referencirani ni od jedne ćelije niti od pravila formatiranja u radnoj knjizi.
Mogu li pročitati LoadDiagnostics čak i kada nije poduzeta nikakva popravka?
Da. Zbirka Issues bit će prazna i HasRepairs i HasDataLossRisk će vratiti false.