Πώς να εργαστείτε με τις βασικές ρυθμίσεις του βιβλίου εργασίας στο .NET

Aspose.Cells FOSS για .NET εκθέτει τη διαμόρφωση σε επίπεδο βιβλίου εργασίας μέσω Workbook.Settings (locale και σύστημα ημερομηνίας), Workbook.DocumentProperties (μεταδεδομένα συγγραφέα), Workbook.LoadDiagnostics (αναφορά επισκευής) και SaveOptions (συμπεριφορά αποθήκευσης). Εγκαταστήστε με μια εντολή dotnet add package.

Οδηγός βήμα-προς-βήμα

Βήμα 1: Εγκατάσταση του πακέτου

dotnet add package Aspose.Cells.FOSS

Βήμα 2: Εισαγωγή του ονοματοχώρου

using Aspose.Cells_FOSS;
using System.Globalization;

Βήμα 3: Διαμόρφωση WorkbookSettings

Workbook.Settings επιστρέφει ένα αντικείμενο WorkbookSettings. Ορίστε Date1904 = true για αρχεία macOS που χρησιμοποιούν το σύστημα ημερομηνιών 1904. Ρυθμίστε Culture για να ελέγξετε τη locale ανάλυσης αριθμών και ημερομηνιών.

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: Ορίστε τις Ιδιότητες του Εγγράφου

Workbook.DocumentProperties εκθέτει τα Title, Subject, Author, Keywords, Comments, Category, Company και Manager ως άμεσες ιδιότητες τύπου string.

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

Βήμα 5: Χρησιμοποιήστε SaveOptions

Workbook.Save(path, SaveOptions) δέχεται ένα αντικείμενο SaveOptions για να προσαρμόσει την έξοδο. Κύριες ιδιότητες: UseSharedStrings (μειώνει το μέγεθος του αρχείου για φύλλα με επαναλαμβανόμενες συμβολοσειρές), ValidateBeforeSave (εκτελεί επαλήθευση πριν από τη γραφή), και CompactStyles (αφαιρεί αχρησιμοποίητα στυλ).

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

Βήμα 6: Διαβάστε το LoadDiagnostics μετά την επιδιόρθωση

Αφού φορτωθεί με το TryRepairPackage = true, ελέγξτε το Workbook.LoadDiagnostics για να δείτε αν εφαρμόστηκαν επιδιορθώσεις.

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

Κοινά Προβλήματα και Διορθώσεις

WorkbookSaveException when ValidateBeforeSave = true. Το βιβλίο εργασίας περιέχει μια δομική ασυνέπεια. Απενεργοποιήστε ValidateBeforeSave προσωρινά για να αποθηκεύσετε και να ελέγξετε το αρχείο, έπειτα διορθώστε το προβληματικό περιεχόμενο.

Ιδιότητες εγγράφου δεν είναι ορατές στον πίνακα Πληροφορίες Αρχείου του Excel. Βεβαιωθείτε ότι ορίζετε τις ιδιότητες στο Workbook.DocumentProperties, όχι Workbook.Properties. Το τελευταίο περιέχει σήματα εμφάνισης, όχι αλφαριθμητικά μεταδεδομένων.

Date1904 = true προκαλεί μετατόπιση των τιμών ημερομηνίας. Το Date1904 αλλάζει την εποχή που χρησιμοποιείται για τους σειριακούς αριθμούς ημερομηνίας. Μόνο ορίστε το σε true για αρχεία που προέρχονται από το macOS Excel με ενεργοποιημένο το σύστημα ημερομηνιών 1904· η ανάμειξη συστημάτων προκαλεί σφάλματα κατά 1462 ημέρες.

Συχνές Ερωτήσεις

Ποια είναι η διαφορά μεταξύ `WorkbookSettings` και `WorkbookProperties`;

WorkbookSettings (μέσω Workbook.Settings) περιέχει τιμές ρυθμίσεων όπως Date1904 και Culture. WorkbookProperties (μέσω Workbook.Properties) περιέχει σημαίες εμφάνισης OOXML όπως ShowObjects. Οι μετα-δεδομένες συμβολοσειρές του εγγράφου (Τίτλος, Συγγραφέας κ.λπ.) βρίσκονται στο Workbook.DocumentProperties.

Αφαιρεί ποτέ το `CompactStyles` τα στυλ που χρειάζομαι;

Όχι. CompactStyles αφαιρεί μόνο τα στυλ που δεν αναφέρονται από κανένα κελί ή κανόνα μορφοποίησης στο βιβλίο εργασίας.

Μπορώ να διαβάσω το `LoadDiagnostics` ακόμη και όταν δεν έγινε καμία προσπάθεια επισκευής;

Ναι. Η συλλογή Issues θα είναι κενή και τόσο το HasRepairs όσο και το HasDataLossRisk θα επιστρέψουν το false.