Práce s nastavením základního pracovního seznamu

Práce s nastavením základního pracovního seznamu

Kromě mřížky pracovního listu obsahuje pracovní kniha metadata a konfiguraci, která ovlivňuje to, jak Excel interpretuje: datový systém, autor dokumentu, lokalita a zda jsou informace o obnovení uložené. Workbook Třída je odhalí prostřednictvím Workbook.Settings, Workbook.Properties,a) Workbook.LoadDiagnostics.Zachování se ovládá prostřednictvím: SaveOptions.

Nastavení pracovního seznamu

Workbook.Settings vrací a WorkbookSettings Objekt. Nastavení Date1904 na … true používat datový systém 1904 (běžný u souborů pocházejících z operačního systému MacOS Excel). Set Culture na a CultureInfo instance na ovládání čísla a data analyzování lokálního.

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 vrací a WorkbookProperties objekt s označením orientovaným na zobrazení, jako je: ShowObjects a) FilterPrivacy.Pro autorství a použití popisných metadát. Workbook.DocumentProperties, které odhaluje Title, Subject, Author, Keywords, Comments, Category, Company,a) Manager jako přímé vlastnosti řetězců.

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 zatížení

Po načtení pracovního seznamu zkontrolujte, zda je Workbook.LoadDiagnostics aby zjistil, jestli knihovna provedla nějaké opravy. LoadDiagnostics.HasRepairs je: true pokud byla provedena alespoň jedna opravná konstrukce. LoadDiagnostics.HasDataLossRisk je: true pokud opravy vyloučily data. Iterovat LoadDiagnostics.Issues k přístupu jednotlivce, DiagnosticEntry předměty 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žení možností

Workbook.Save(path, SaveOptions) přijímá a SaveOptions zamítnout přizpůsobení výstupu uložení. UseSharedStrings ovládá, zda jsou hodnoty řetězců uloženy ve sdílené tabulce řety (snižuje velikost souboru pro listy se spoustou opakovaných řetízek). ValidateBeforeSave před psaním spustí interní ověření pracovního seznamu. CompactStyles odstraní nepoužívané styly. PreserveRecoveryMetadata kontroluje, zda jsou zachovány metadata pro obnovení 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 nejlepší postupy

• Ček. LoadDiagnostics.HasDataLossRisk po načtení opravovaných souborů a varovat uživatele, pokud by mohlo dojít k ztrátě dat.
• Sestavení: DocumentProperties.Author a) Company pro soubory sdílené s koncovými uživateli tyto jsou zobrazeny v panelu informací o souborech programu Excel.
• UseSharedStrings = true je prospěšná pro listy s mnoha opakovanými hodnotami řetězců (např. sloupce stavu); má minimální dopad na listové listiny se značnou počtem čísel.
• Date1904 musí odpovídat mezi zdrojovým a cílovým souborem, aby se zabránilo odchýlení hodnoty data při kopírování buněk mezi pracovními učebnicemi.

Obvyklé problémy

FAQ

Jaký je rozdíl mezi WorkbookProperties a) DocumentProperties?

WorkbookProperties (přístupem: Workbook.Properties) obsahuje OOXML zobrazovací značky (např. ShowObjects). DocumentProperties (přístupem: Workbook.DocumentProperties) obsahuje řetězce metadaten ve stylu Dublin-Core: Název, Autor, Společnost atd.

- Ano. CompactStyles Vymazat ty styly, které potřebuji?

CompactStyles odstraní pouze typy, na které není odkazováno žádným bunku, podmíněný formát nebo pojmenovaný styl. Používané styly nejsou nikdy odstraněny.

Můžu číst? LoadDiagnostics i když se nepokusil opravit?

Když se nepokusila opravit, tak… Issues Sbírka je prázdná a obě jsou vymazané. HasRepairs a) HasDataLossRisk zpětné přepravu false.

Souhrnná referenční informace API