نحوه کار با بسته‌بندی OOXML در .NET

یک فایل XLSX یک آرشیو ZIP بر پایه Open Packaging Convention (OPC) است. Aspose.Cells FOSS for .NET ساختار بسته زیرین را از طریق PackageModel، PackagePartDescriptor، IPackageReader و IPackageWriter در دسترس قرار می‌دهد. این‌ها APIهای سطح زیرساخت هستند که عمدتاً برای تشخیص و پیاده‌سازی‌های ذخیره‌سازی سفارشی مفیدند. با 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 به‌طور کامل گم شده باشد). فایل را با unzip -t file.xlsx بررسی کنید که یک ZIP معتبر است. اگر معتبر باشد، ممکن است رمزگذاری شده باشد — فایل‌های محافظت‌شده با رمز عبور پشتیبانی نمی‌شوند.

Workbook بارگذاری می‌شود اما برخی محتواها گم شده‌اند. LoadDiagnostics.Issues را برای ورودی‌های DataLossRisk = true بررسی کنید. این‌ها نشان می‌دهند که بخش‌هایی در طول تعمیر حذف شده‌اند.

IPackageReader سفارشی فراخوانی نمی‌شود.
اطمینان حاصل کنید که نسخهٔ سازنده‌ای که خوانندهٔ سفارشی را می‌پذیرد، استفاده شود. همهٔ overloadهای سازندهٔ Workbook خوانندهٔ بستهٔ سفارشی را نمی‌پذیرند.

سوالات متداول

چه زمانی باید IPackageReader یا IPackageWriter را پیاده‌سازی کنم؟

فقط زمانی که پشتیبان ذخیره‌سازی شما سیستم فایل محلی نیست — برای مثال، بارگذاری مستقیم از یک جریان ذخیره‌سازی ابری بدون ایجاد فایل موقت.

آیا بخش‌های پشتیبانی‌نشده در PackageModel هنگام ذخیره‌سازی حفظ می‌شوند؟

قسمت‌های غیر استاندارد در UnsupportedParts تضمین نمی‌شود که بازنویسی شوند. برای حفظ صحت دورانی قسمت‌های غیر استاندارد، پس از ذخیره‌سازی XLSX را در سطح ZIP پردازش کنید.

تفاوت بین PackageStructureException و WorkbookLoadException چیست؟

PackageStructureException یک خطای سطح OPC/ZIP است (نوع محتوا گم شده، رابطه خراب). WorkbookLoadException یک خطای سطح بالاتر در تجزیه محتوای XML XLSX است.

همچنین ببینید

• کار با بسته‌بندی OOXML
• نحوه بارگذاری یک صفحه‌گسترده در .NET
• سوالات متداول