Kā strādāt ar Core Workbook iestatījumiem .NET

Aspose.Cells FOSS for .NET nodrošina darblapas līmeņa konfigurāciju caur Workbook.Settings (lokāle un datuma sistēma), Workbook.DocumentProperties (autora metadati), Workbook.LoadDiagnostics (labojuma ziņojums) un SaveOptions (saglabāšanas uzvedība). Instalējiet ar dotnet add package Aspose.Cells_FOSS.

Rokasgrāmata soli pa solim

1. solis: instalēt pakotni

dotnet add package Aspose.Cells_FOSS

2. solis: importēt nosaukumtelpu

using Aspose.Cells_FOSS;
using System.Globalization;

3. solis: Konfigurēt WorkbookSettings

Workbook.Settings atgriež WorkbookSettings objektu. Iestatiet Date1904 = true macOS izcelsmes failiem, kas izmanto 1904 datuma sistēmu. Iestatiet Culture, lai kontrolētu skaitļu un datumu parsēšanas lokalizāciju.

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

4. solis: Iestatīt dokumenta īpašības

Workbook.DocumentProperties padara pieejamus Title, Subject, Author, Keywords, Comments, Category, Company un Manager kā tiešas virknes īpašības.

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

Solis 5: Izmantot SaveOptions

Workbook.Save(path, SaveOptions) pieņem SaveOptions objektu, lai pielāgotu izvadi. Galvenās īpašības: UseSharedStrings (samazina faila lielumu lapām ar atkārtotiem virknēm), ValidateBeforeSave (veic validāciju pirms rakstīšanas) un CompactStyles (noņem neizmantotus stilus).

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

Solis 6: Nolasīt LoadDiagnostics pēc remonta

Pēc ielādes ar TryRepairPackage = true, pārbaudiet Workbook.LoadDiagnostics, lai redzētu, vai tika veikti kādi labojumi.

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

Biežas problēmas un risinājumi

WorkbookSaveException kad ValidateBeforeSave = true. Darblapa satur strukturālu nesaskaņu. Īslaicīgi atspējojiet ValidateBeforeSave, lai saglabātu un pārbaudītu failu, pēc tam novērsiet problemātisko saturu.

Dokumenta īpašības nav redzamas Excel Faila informācijas panelī.
Pārliecinieties, ka iestatāt īpašības uz Workbook.DocumentProperties, nevis Workbook.Properties. Pēdējais satur attēlošanas karogus, nevis metadatu virknes.

Date1904 = true izraisa datumu vērtību nobīdi.
Date1904 maina epohu, ko izmanto datumu sērijas numuri. Tikai iestatiet to uz true failiem, kas izcēluši no macOS Excel ar aktivizētu 1904 datumu sistēmu; sistēmu sajaukšana izraisa 1462 dienu novirzes kļūdas.

Biežāk uzdotie jautājumi

Kāda ir atšķirība starp `WorkbookSettings` un `WorkbookProperties`?

WorkbookSettings (caur Workbook.Settings) satur konfigurācijas vērtības, piemēram, Date1904 un Culture. WorkbookProperties (caur Workbook.Properties) satur OOXML attēlošanas karogus, piemēram, ShowObjects. Dokumenta metadatu virknes (Nosaukums, Autors utt.) atrodas Workbook.DocumentProperties.

Vai `CompactStyles` kādreiz noņem stilus, kas man vajadzīgi?

Nē. CompactStyles tikai noņem stilus, kas nav atsaukti nevienā šūnā vai formāta noteikumā darblapā.

Vai es varu lasīt `LoadDiagnostics` pat ja netika mēģināts neviens remonts?

Jā. Issues kolekcija būs tukša, un gan HasRepairs, gan HasDataLossRisk atgriezīs false.