Πώς να εργαστείτε με το πακέτο OOXML στο .NET

Ένα αρχείο XLSX είναι ένα αρχείο ZIP σύμφωνα με το Open Packaging Convention (OPC). Το Aspose.Cells FOSS for .NET εκθέτει τη βασική δομή του πακέτου μέσω PackageModel, PackagePartDescriptor, IPackageReader και IPackageWriter. Αυτά είναι APIs επιπέδου υποδομής που είναι κυρίως χρήσιμα για διαγνωστικούς σκοπούς και προσαρμοσμένες υλοποιήσεις αποθήκευσης. Εγκαταστήστε το με dotnet add package Aspose.Cells_FOSS.

Οδηγός βήμα-βήμα

dotnet add package Aspose.Cells_FOSS

using Aspose.Cells_FOSS;

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true };

try
{
    var wb = new Workbook("suspect.xlsx", opts);
    Console.WriteLine("Loaded: " + wb.Worksheets.Count + " sheet(s)");
}
catch (PackageStructureException ex)
{
    Console.WriteLine("OPC structure invalid: " + ex.Message);
}
catch (WorkbookLoadException ex)
{
    Console.WriteLine("Load error: " + ex.Message);
}

// Signature reference
// public interface IPackageReader { void Read(/* ... */); }
// public interface IPackageWriter { void Write(/* ... */); }
//
// Standard usage: pass a Stream to the Workbook constructor
using Aspose.Cells_FOSS;
using System.IO;

byte[] fileBytes = File.ReadAllBytes("data.xlsx");
using var ms = new MemoryStream(fileBytes);
var wb = new Workbook(ms);
Console.WriteLine("Loaded from stream: " + wb.Worksheets.Count + " sheet(s)");

// PackageModel is populated internally during Workbook construction.
// Use LoadDiagnostics to detect load-time structural warnings without
// dropping to the PackageModel level directly.
using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
var diag = wb.LoadDiagnostics;
if (diag.HasRepairs)
    Console.WriteLine("Package had " + diag.Issues.Count() + " repair entries.");

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

PackageStructureException εκτοξεύεται ακόμη και με TryRepairPackage = true.
Ορισμένες δομικές αποτυχίες OPC είναι πέρα από την αυτόματη επισκευή (π.χ. εντελώς ελλιπής χάρτης content-type). Επαληθεύστε ότι το αρχείο είναι έγκυρο ZIP με unzip -t file.xlsx. Εάν είναι έγκυρο, μπορεί να είναι κρυπτογραφημένο — τα αρχεία με προστασία κωδικού πρόσβασης δεν υποστηρίζονται.

Workbook φορτώνει αλλά λείπουν ορισμένα περιεχόμενα.
Ελέγξτε LoadDiagnostics.Issues για καταχωρήσεις DataLossRisk = true. Αυτά υποδεικνύουν τμήματα που αφαιρέθηκαν κατά την επισκευή.

Custom IPackageReader δεν καλείται.
Βεβαιωθείτε ότι χρησιμοποιείται η υπερφόρτωση του κατασκευαστή που δέχεται τον προσαρμοσμένο αναγνώστη. Δεν όλες οι υπερφορτώσεις του κατασκευαστή Workbook δέχονται έναν προσαρμοσμένο αναγνώστη πακέτου.

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

Πότε πρέπει να υλοποιήσω το IPackageReader ή το IPackageWriter;

Μόνο όταν η αποθηκευτική υποδομή σας δεν είναι το τοπικό σύστημα αρχείων — για παράδειγμα, φορτώνοντας απευθείας από ροή αποθήκευσης στο σύννεφο χωρίς να δημιουργήσετε προσωρινό αρχείο.

Διατηρούνται τα μη υποστηριζόμενα μέρη στο PackageModel κατά την αποθήκευση;

Τα μη τυποποιημένα τμήματα στο UnsupportedParts δεν εγγυώνται ότι θα γραφούν ξανά. Για πιστότητα κυκλικής επεξεργασίας των μη τυποποιημένων τμημάτων, επεξεργαστείτε μεταγενέστερα το αποθηκευμένο XLSX σε επίπεδο ZIP.

Ποια είναι η διαφορά μεταξύ του PackageStructureException και του WorkbookLoadException;

PackageStructureException είναι αποτυχία επιπέδου OPC/ZIP (έλλειψη τύπου περιεχομένου, σπασμένη σχέση). WorkbookLoadException είναι αποτυχία υψηλότερου επιπέδου στην ανάλυση του περιεχομένου XML του XLSX.

Δείτε επίσης

• Εργασία με τη συσκευασία OOXML
• Πώς να φορτώσετε ένα φύλλο εργασίας σε .NET
• Συχνές Ερωτήσεις