Rad s osnovnim postavkama radne sveske

Rad s osnovnim postavkama radne sveske

Osim mreže radnog lista, radna sveska nosi metapodatke i konfiguraciju koja utječe na to kako Excel tumači: sustav datuma, autor dokumenta, lokalno područje i da li se informacije o oporavku pohranjuju. Workbook Klasa ih izloži kroz Workbook.Settings, Workbook.Properties, i Workbook.LoadDiagnostics.-Pokretanje ponašanja kontrolira se putem: SaveOptions.

Način na koji se obrađivanje vrši

Workbook.Settings vraća a WorkbookSettings -Obijek. Date1904 u iznosu od: true za korištenje datoteka iz 1904. godine (običan je u datotekama koje potiču od macOS Excel-a). Set Culture u iznosu od: CultureInfo U slučaju da je broj i datum lokalno.

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

Priroda dokumenta

Workbook.Properties vraća a WorkbookProperties objekat s prikazom orijentiranim zastavama kao što su: ShowObjects i u članku 1. FilterPrivacy.Za autorsko ime i opisivanje metapodataka Workbook.DocumentProperties, što otkriva: Title, Subject, Author, Keywords, Comments, Category, Company, i Manager kao direktna svojstva nizova.

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

Opterećenje:

Nakon što učitavanje radnog sveska, provjerite Workbook.LoadDiagnostics Da otkrije je li biblioteka primenila bilo kakvu popravku. LoadDiagnostics.HasRepairs je: true ako je izvršena barem jedna popravka strukture. LoadDiagnostics.HasDataLossRisk je: true Ako je popravak odbacio podatke. Iterirati LoadDiagnostics.Issues pristup pojedinačnim DiagnosticEntry objekte s: Code, Severity, Message, RepairApplied, i 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);
}

Shrani opcije

Workbook.Save(path, SaveOptions) prihvaćaju: SaveOptions Odgovornost za prilagođavanje rezultata uštede. UseSharedStrings kontrolira se da li su vrijednosti nizova pohranjene u zajedničkoj tablici niza (smanjuje veličinu datoteke za listove s mnogim ponavljanjem nizaka). ValidateBeforeSave provodi internog potvrđivanja radne sveske prije pisanja. CompactStyles uklanja neiskorištene stilove. PreserveRecoveryMetadata U ovom članku se navode sljedeće uvjete:.

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

Savjeti i najbolje prakse

• Čekaj. LoadDiagnostics.HasDataLossRisk Nakon učitavanja popravljenih datoteka i upozorenje korisnika ako su podaci možda ispali.
• Sastavljeno DocumentProperties.Author i u članku 1. Company za datoteke koje su dijelite s krajnjim korisnicima one se pojavljuju u Excelovoj info ploči.
• UseSharedStrings = true U ovom slučaju, ako je to moguće, treba se koristiti za primjenu u skladu s člankom 21. stavkom 2.
• Date1904 mora se poklopiti između izvorne i ciljne datoteke kako bi se izbjeglo pomicanje vrijednosti datuma pri kopiranju stanica između radnih sveski.

Zajednički problemi

FAQ

Koja je razlika između: WorkbookProperties i u članku 1. DocumentProperties?

WorkbookProperties (preko: Workbook.PropertiesU ovom članku se navode sljedeće uvjete:. ShowObjects). DocumentProperties (preko: Workbook.DocumentPropertiesU članku 1. stavku 2. navodi se sljedeće:.

Da li je? CompactStyles Da izbrišem stilove koji mi trebaju?

CompactStyles uklanja samo stilove koji nisu upućeni u bilo koju ćeliju, uvjetni format ili imenovani stil. U upotrebi stilovi nikada ne uklone.

Mogu li čitati? LoadDiagnostics čak i kada se nije pokušao popraviti?

Da, kada se nije pokušalo popraviti… Issues zbirka je prazna i oboje HasRepairs i u članku 1. HasDataLossRisk povratak false.

Svrha referentnog API-a