Práca s nastavením základného pracovníka

Práca s nastavením základného pracovníka

Okrem mriežky hárkov obsahuje pracovná kniha metadata a konfiguráciu, ktorá ovplyvňuje to, ako ju Excel interpretuje: systém dát, autor dokumentu, lokalitu a či sú uložené informácie o obnovení. Workbook trieda ich odhaľuje prostredníctvom Workbook.Settings, Workbook.Properties,a) Workbook.LoadDiagnostics.Správa sa riadi prostredníctvom: SaveOptions.

Nastavenia pracovného zoznamu

Workbook.Settings vráti a WorkbookSettings Objekt. Nastavenie Date1904 na: true Použiť systém dátumu 1904 (bežný v súboroch pochádzajúcich z macOS Excel). Nastaviť Culture na a CultureInfo Inštitúcia na kontrolu čísla a dátumu v lokalite analýzy.

using Aspose.Cells_FOSS;
using System.Globalization;

var wb = new Workbook();

// Use 1904 date system
wb.Settings.Date1904 = true;

// Set culture for number/date formatting
wb.Settings.Culture = new CultureInfo("en-US");

wb.Worksheets[0].Cells["A1"].PutValue("Settings applied");
wb.Save("settings.xlsx");

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

Vlastnosti dokumentu

Workbook.Properties vráti a WorkbookProperties objekt s zobrazovateľnými označeniami, ako sú: ShowObjects a) FilterPrivacy.Pre autorstvo a použitie opisných metadát . Workbook.DocumentProperties, ktoré odhaľujú: Title, Subject, Author, Keywords, Comments, Category, Company,a) Manager ako priame vlastnosti reťazca.

using Aspose.Cells_FOSS;

var wb = new Workbook();

var doc = wb.DocumentProperties;
doc.Title = "Quarterly Report";
doc.Subject = "Sales Data";
doc.Author = "Reporting Team";
doc.Company = "Contoso Ltd";
doc.Keywords = "sales, quarterly, 2026";
doc.Comments = "Generated by automated pipeline";

wb.Worksheets[0].Cells["A1"].PutValue("See document properties");
wb.Save("properties.xlsx");

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

Diagnostika zaťaženia

Po načítaní pracovného zoznamu skontrolujte: Workbook.LoadDiagnostics aby zistili, či knižnica vykonala nejaké opravy. LoadDiagnostics.HasRepairs je: true ak bola vykonaná aspoň jedna konštrukčná oprava. LoadDiagnostics.HasDataLossRisk je: true Ak sa opravou vylúčili údaje. Iterovať LoadDiagnostics.Issues prístup k individuálnym DiagnosticEntry predmety s: Code, Severity, Message, RepairApplied,a) DataLossRisk.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };

try
{
    var wb = new Workbook("possibly-corrupt.xlsx", opts);
    var diag = wb.LoadDiagnostics;

    if (diag.HasRepairs)
    {
        Console.WriteLine("Repairs applied: " + diag.HasRepairs);
        Console.WriteLine("Data loss risk: " + diag.HasDataLossRisk);
        foreach (var entry in diag.Issues)
        {
            Console.WriteLine($"  [{entry.Severity}] {entry.Code}: {entry.Message}");
            Console.WriteLine($"  RepairApplied={entry.RepairApplied}, DataLossRisk={entry.DataLossRisk}");
        }
    }
    else
    {
        Console.WriteLine("File loaded cleanly.");
    }
}
catch (WorkbookLoadException ex)
{
    Console.WriteLine("Unrecoverable: " + ex.Message);
}

Uložiť možnosti

Workbook.Save(path, SaveOptions) prijíma a SaveOptions odporučiť prispôsobenie výstupu uloženia. UseSharedStrings ovláda, či sú hodnoty reťazcov uložené v zdieľanej tabuľke reže (zníži veľkosť súborov pre listy s mnohými opakovanými reťaziami). ValidateBeforeSave pred písaním spustí vnútornú validáciu pracovnej knihy. CompactStyles odstránenie nepoužívaných štýlov. PreserveRecoveryMetadata kontroluje, či sa zachovávajú obnoviteľné metadaty Office.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

for (var i = 0; i < 100; i++)
    ws.Cells[i, 0].PutValue("Repeated string value");

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

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

Tipy a najlepšie postupy

• Prehľad LoadDiagnostics.HasDataLossRisk po načítaní opravených súborov a varovať používateľov, ak sa mohli údaje stratiť.
• Sadzba DocumentProperties.Author a) Company pre súbory zdieľané s koncovými používateľmi tieto sa zobrazujú v informačnom paneli súborov programu Excel.
• UseSharedStrings = true je prospešná pre listy s mnohými opakovanými hodnotami reťazcov (napr. stavové stĺpce); má minimálny vplyv na listov s vysokou počtom údajov.
• Date1904 musí zodpovedať medzi zdrojovým a cieľovým súborom, aby sa zabránilo odchýleniu hodnoty dátumu pri kopírovaní buniek medzi pracovnými knižkami.

Spoločné problémy

FAQ

Aký je rozdiel medzi: WorkbookProperties a) DocumentProperties?

WorkbookProperties (prostredníctvom: Workbook.Properties) obsahuje OOXML zobrazovacie značky (napr. ShowObjects). DocumentProperties (prostredníctvom: Workbook.DocumentProperties) obsahuje metadátové reťazce v štýle Dublin-Core: názov, autor, spoločnosť atď.

Je to tak ? CompactStyles Vymazať štýly, ktoré potrebujem?

CompactStyles odstráni iba typy, na ktoré nie je odkazovaná žiadna bunka, podmienený formát alebo pomenovaný štýl. Používané štýly sa nikdy neodstránia.

Môžem čítať ? LoadDiagnostics aj keď sa nepokúšali opraviť?

Keď sa nepokúsila opraviť, Issues Zbierka je prázdna a obaja sú v poriadku. HasRepairs a) HasDataLossRisk vrátenie false.

Zhrnutie referenčného API