Kaip dirbti su pagrindiniais darbalapio nustatymais .NET

Aspose.Cells FOSS for .NET atskleidžia darbaknygės lygio konfigūraciją per Workbook.Settings (lokalė ir datos sistema), Workbook.DocumentProperties (autoriaus metaduomenys), Workbook.LoadDiagnostics (remonto ataskaita) ir SaveOptions (išsaugojimo elgsena). Įdiekite naudodami dotnet add package Aspose.Cells_FOSS.

Žingsnis po žingsnio vadovas

1 žingsnis: įdiekite paketą

dotnet add package Aspose.Cells_FOSS

Žingsnis 2: importuoti vardų sritį

using Aspose.Cells_FOSS;
using System.Globalization;

3 žingsnis: Konfigūruoti WorkbookSettings

Workbook.Settings grąžina WorkbookSettings objektą. Nustatykite Date1904 = true macOS kilusioms byloms, kurios naudoja 1904 metų datos sistemą. Nustatykite Culture, kad kontroliuotumėte skaičių ir datos analizės lokalę.

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

Žingsnis 4: Nustatyti dokumento savybes

Workbook.DocumentProperties atskleidžia Title, Subject, Author, Keywords, Comments, Category, Company ir Manager kaip tiesiogines eilutės savybes.

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

Žingsnis 5: Naudoti SaveOptions

Workbook.Save(path, SaveOptions) priima SaveOptions objektą, kad pritaikytų išvestį. Pagrindinės savybės: UseSharedStrings (sumažina failo dydį lapams su pasikartojančiomis eilutėmis), ValidateBeforeSave (atlieka patikrinimą prieš rašymą) ir CompactStyles (šalina nenaudojamus stilius).

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

Žingsnis 6: Perskaityti LoadDiagnostics po remonto

Įkėlus su TryRepairPackage = true, patikrinkite Workbook.LoadDiagnostics, ar buvo atlikti kokie nors remontai.

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

Dažnos problemos ir sprendimai

WorkbookSaveException kai ValidateBeforeSave = true.
Darbo knyga turi struktūrinį nesuderinamumą. Laikinai išjunkite ValidateBeforeSave, kad išsaugotumėte ir patikrintumėte failą, tada ištaisykite problematišką turinį.

Dokumento savybės nematomos Excel programos Failo informacijos skydelyje.
Įsitikinkite, kad nustatote savybes Workbook.DocumentProperties, o ne Workbook.Properties. Ši paskutinė saugo rodymo vėliavas, o ne metaduomenų eilutes.

Date1904 = true sukelia datos reikšmių poslinkį. Date1904 keičia epochą, naudojamą datos serijinių numerių skaičiavimui. Nustatykite jį į true tik failams, kurie kilo iš macOS Excel su įjungta 1904 datos sistema; sistemų maišymas sukelia 1462 dienų paklaidas.

Dažnai užduodami klausimai

Kuo skiriasi `WorkbookSettings` ir `WorkbookProperties`?

WorkbookSettings (per Workbook.Settings) saugo konfigūracijos reikšmes, tokias kaip Date1904 ir Culture. WorkbookProperties (per Workbook.Properties) saugo OOXML rodymo vėliavas, pvz., ShowObjects. Dokumento metaduomenų eilutės (Pavadinimas, Autorius ir kt.) yra Workbook.DocumentProperties.

Ar `CompactStyles` kada nors pašalina stilius, kurių man reikia?

Ne. CompactStyles tik pašalina stilius, kurie nėra nurodyti jokio langelio ar formato taisyklės darbaknygoje.

Ar galiu perskaityti `LoadDiagnostics` net jei nebuvo bandyta taisyti?

Taip. Issues kolekcija bus tuščia ir tiek HasRepairs, tiek HasDataLossRisk grąžins false.