Jak pracovat s balíčkováním OOXML v .NET

Soubor XLSX je archiv ZIP podle Open Packaging Convention (OPC). Aspose.Cells FOSS pro .NET odhaluje podkladovou strukturu balíčku prostřednictvím PackageModel, PackagePartDescriptor, IPackageReader a IPackageWriter. Jedná se o API na úrovni infrastruktury, která jsou především užitečná pro diagnostiku a vlastní implementace úložiště. Nainstalujte pomocí dotnet add package Aspose.Cells_FOSS.

Průvodce krok za krokem

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

Časté problémy a opravy

PackageStructureException je vyvolána i při TryRepairPackage = true. Některá strukturální selhání OPC jsou mimo automatickou opravu (např. úplně chybějící mapa typů obsahu). Ověřte, že soubor je platný ZIP pomocí unzip -t file.xlsx. Pokud je platný, může být šifrován — soubory chráněné heslem nejsou podporovány.

Workbook se načte, ale některý obsah chybí. Check LoadDiagnostics.Issues for DataLossRisk = true záznamy. To naznačuje části, které byly během opravy vypuštěny.

Custom IPackageReader není volána. Ujistěte se, že je použito přetížení konstruktoru, které přijímá vlastní čtečku. Ne všechny Workbook přetížení konstruktoru přijímají vlastní čtečku balíčku.

Často kladené otázky

Kdy bych měl implementovat IPackageReader nebo IPackageWriter?

Pouze když je vaše úložiště backendem, který není lokální souborový systém — například při načítání přímo ze streamu cloudového úložiště bez vytváření dočasného souboru.

Zůstávají nepodporované části v PackageModel při uložení zachovány?

Nestandardní části v UnsupportedParts nejsou zaručeny, že budou zapsány zpět. Pro zachování úplné věrnosti nestandardních částí během celého cyklu je potřeba po uložení souboru XLSX provést post-processing na úrovni ZIP.

Jaký je rozdíl mezi PackageStructureException a WorkbookLoadException?

PackageStructureException je selhání úrovně OPC/ZIP (chybějící typ obsahu, poškozený vztah). WorkbookLoadException je selhání vyšší úrovně při parsování obsahu XLSX XML.

Viz také:

• Práce s balíčky OOXML
• Jak načíst tabulku v .NET
• Často kladené otázky
• Aspose.Cells for .NET — Enterprise Knowledge Base