Jak pracovat s nastavením základního pracovního seznamu v .NET

Jak pracovat s nastavením základního pracovního seznamu v .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (systém místních a datových), Workbook.DocumentProperties (metadata o autorovi), Workbook.LoadDiagnostics (zpráva o opravách) a SaveOptions (Uchraňování chování). dotnet add package Aspose.Cells_FOSS.

Krok za krokem

Krok 1: Nainstalujte balíček

dotnet add package Aspose.Cells_FOSS

Krok 2: Importovat prostor pro jména

using Aspose.Cells_FOSS;
using System.Globalization;

Krok 3: Nastavení pracovní knihy

Workbook.Settings vrací a WorkbookSettings Objekt. Nastavení Date1904 = true pro soubory pocházející z operačního systému macOS, které používají datový systém 1904. Nastavit Culture na ovládání čísla a data pro analýzu lokálního systému.

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

Krok 4: Nastavit vlastnosti dokumentu

Workbook.DocumentProperties expozice Title, Subject, Author, Keywords, Comments, Category, Company,a) Manager jako přímé vlastnosti řetězců.

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

Krok 5: Použijte SaveOptions

Workbook.Save(path, SaveOptions) přijímá a SaveOptions Kladné vlastnosti: UseSharedStrings (snižuje velikost souboru pro listy s opakovanými řádky), ValidateBeforeSave (prochází validací před psaním) a CompactStyles (odstraňuje nepoužívané styly).

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

Krok 6: Číst diagnostiky zatížení po opravě

Po naložení s TryRepairPackage = true, kontrolujte Workbook.LoadDiagnostics aby zjistil, zda byla provedena nějaká oprava.

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

Obvyklé problémy a řešení

WorkbookSaveException kdy? ValidateBeforeSave = true. Pracovní kniha obsahuje strukturální nesrovnalost. ValidateBeforeSave dočasně uložit a zkontrolovat soubor, pak opravit problémový obsah.

Vlastnosti dokumentu nejsou viditelné v panelu Informace o souborech programu Excel. Ujistěte se, že nastavíte vlastnosti na Workbook.DocumentProperties, ne . Workbook.Properties.V tomto případě jsou zobrazeny značky, ne řetězce metadát.

Date1904 = true způsobuje posun hodnot dat. Datum 1904 mění epochu používanou pro sériová čísla dat. Pouze nastavit na true pro soubory pocházející z systému macOS Excel s povoleným datovým systémem 1904; smíchání způsobuje chyby v období 1462 dnů.

Časté otázky

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

WorkbookSettings (přístupem: Workbook.Settings) obsahuje konfigurační hodnoty jako: Date1904 a) Culture. WorkbookProperties (přístupem: Workbook.Properties) obsahuje OOXML zobrazení vlajky, jako je: ShowObjects. řetězce metadát dokumentu (titul, autor atd.) jsou v Workbook.DocumentProperties.

- Ano. CompactStyles Už jsi mi někdy odstranil ty, co potřebuju?

  • Ne, ne. - Cože?. CompactStyles odstraní pouze typy, na které se v pracovním seznamu nevztahuje žádné pravidlo pro buňky nebo formát.

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

Ano, to je ono. Issues Sbírka bude prázdná a obě budou vymazány. HasRepairs a) HasDataLossRisk vrátí se. false.

Viz také:

 Čeština