Comment travailler avec le packaging OOXML dans .NET

Un fichier XLSX est une archive ZIP conforme à la convention Open Packaging Convention (OPC). Aspose.Cells FOSS for .NET expose la structure du package sous‑jacent via PackageModel, PackagePartDescriptor, IPackageReader et IPackageWriter. Il s’agit d’API de niveau infrastructure principalement utiles pour le diagnostic et les implémentations de stockage personnalisées. Installez avec dotnet add package Aspose.Cells_FOSS.

Guide étape par étape

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

Problèmes courants et solutions

PackageStructureException est levé même avec TryRepairPackage = true.
Certaines défaillances structurelles d’OPC dépassent la réparation automatique (p. ex. carte content-type complètement manquante). Vérifiez que le fichier est un ZIP valide avec unzip -t file.xlsx. S’il est valide, il peut être chiffré — les fichiers protégés par mot de passe ne sont pas pris en charge.

Workbook charge mais il manque du contenu.
Vérifiez LoadDiagnostics.Issues pour les entrées DataLossRisk = true. Celles‑ci indiquent les parties qui ont été supprimées lors de la réparation.

Custom IPackageReader n’est pas appelé.
Assurez-vous que la surcharge du constructeur qui accepte le lecteur personnalisé est utilisée. Toutes les surcharges du constructeur Workbook n’acceptent pas un lecteur de package personnalisé.

Foire aux questions

Quand devrais-je implémenter IPackageReader ou IPackageWriter ?

Uniquement lorsque votre backend de stockage n’est pas le système de fichiers local — par exemple, en chargeant directement depuis un flux de stockage cloud sans créer de fichier temporaire.

Les parties non prises en charge dans PackageModel sont‑elles conservées lors de l’enregistrement?

Les parties non standard dans UnsupportedParts ne sont pas garanties d’être réécrites. Pour assurer la fidélité en aller‑retour des parties non standard, post‑traitez le fichier XLSX enregistré au niveau du ZIP.

Quelle est la différence entre PackageStructureException et WorkbookLoadException ?

PackageStructureException est une défaillance au niveau OPC/ZIP (type de contenu manquant, relation cassée). WorkbookLoadException est une défaillance de niveau supérieur lors de l’analyse du contenu XML XLSX.

Voir aussi

• Travailler avec le packaging OOXML
• Comment charger une feuille de calcul dans .NET
• Foire aux questions