Kako raditi s osnovnim postavkama radne knjige u .NET-u

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_FOSS

Korak 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.

Vidi također

 Hrvatski