A fő munkaműkönyv beállításaival való munka

A fő munkaműkönyv beállításaival való munka

A munkalapokból eltekintve a munkafüzet metadata- és konfigurációs formátumokat tartalmaz, amelyek befolyásolják az Excel értelmezését: dátumrendszer, dokumentum szerzője, helybeli beállítása és hogy tárolásra kerülnek-e helyreállításra vonatkozó információk. Workbook A tanfolyam ezeket a képeket mutatja ki. Workbook.Settings, Workbook.Properties,és a következők: Workbook.LoadDiagnostics.A mentési viselkedést a SaveOptions.

Munkafüzet beállításai

Workbook.Settings az a-t adja vissza. WorkbookSettings A tárgy. Date1904 a … true A 1904-es dátumrendszer használatára (a macOS Excelből származó fájlokban gyakori). Set Culture a) az alábbiak szerint: CultureInfo A szám és a dátum elemzésének helyét.

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

Dokumentum tulajdonságai

Workbook.Properties az a-t adja vissza. WorkbookProperties objektum, amely kijelzőre orientált jelzőkkel rendelkezik, például: ShowObjects és a FilterPrivacy.A szerzői jog és a leíró metaadatok használata Workbook.DocumentProperties, ami felfedi a Title, Subject, Author, Keywords, Comments, Category, Company, és Manager mint közvetlen szalag tulajdonságok.

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

Töltési diagnosztikai módszerek

A munkafüzet betöltését követően ellenőrizze, Workbook.LoadDiagnostics hogy kiderítsük, a könyvtár bármilyen javítást hajtott végre. LoadDiagnostics.HasRepairs a következő: true ha legalább egy szerkezeti javítást végeztek. LoadDiagnostics.HasDataLossRisk a következő: true ha a javítás eldobta az adatokat. LoadDiagnostics.Issues az egyéni hozzáféréshez. DiagnosticEntry tárgyak, amelyek Code, Severity, Message, RepairApplied,és a következők: 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);
}

Válaszokat menteni

Workbook.Save(path, SaveOptions) elfogadja a SaveOptions a mentési kimenetel testre szabására való tiltakozás. UseSharedStrings ellenőrzi, hogy a szalagértékeket tárolják-e az osztott szalak táblázatában (csökkenti a fájlméretét sok ismétlődő szalatú lap esetében). ValidateBeforeSave a munkafüzet belső validálását futtatja az írás előtt. CompactStyles eltávolítja a nem használt stílusokat. PreserveRecoveryMetadata ellenőrzi, hogy az Office helyreállítási metadata-i megőrződtek-e.

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

Tippek és legjobb gyakorlatok

• A csekk. LoadDiagnostics.HasDataLossRisk a javított fájlok betöltése után, és figyelmezteti az felhasználókat arra vonatkozóan, hogy esetleg elveszítettek-e adatok.
• Összeállítva DocumentProperties.Author és a következők: Company a végfelhasználókkal megosztott fájlok ezek az Excel fájl információs panelében jelennek meg.
• UseSharedStrings = true hasznos a sok ismétlődő sorértékű lapok esetében (pl. státuszoszlopok); minimális hatást gyakorol a számszerűen nehéz lapokra.
• Date1904 A munkafüzetek közötti sejt másolása során a dátumérték-visszavonulás elkerülése érdekében az eredet és célfájl között egyeztetni kell.

Általános kérdések

FAQ

Mi a különbség az EU és az Egyesült Királyság között? WorkbookProperties és a következők: DocumentProperties?

WorkbookProperties (a Bizottságon keresztül) Workbook.Properties) tartalmazza az OOXML kijelző jelvényeket (pl. ShowObjects). DocumentProperties (a Bizottságon keresztül) Workbook.DocumentProperties) tartalmazza a Dublin-Core típusú metaadatok szalagokat: cím, szerző, cég stb.

- Igen. CompactStyles Ki kell törölnöm a stílusokat?

CompactStyles csak olyan stílusokat távolít el, amelyekre nem hivatkozik se cellában, sem feltételleges formátumban vagy megnevezett stílust. A használatban lévő stílukok soha nem kerülnek eltávolításra.

Olvashatok? LoadDiagnostics Még akkor is, ha nem próbálták megjavítani?

Igen, amikor nem próbálták megjavítani a… Issues A gyűjtemény üres, és mindkettő. HasRepairs és a következők: HasDataLossRisk visszavonás false.

API-referencia összefoglaló