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

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

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

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

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

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

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

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

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

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

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

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

• کار با بسته‌بندی OOXML
• نحوه بارگذاری یک صفحه‌گسترده در .NET
• سوالات متداول
• Aspose.Cells for .NET — Enterprise Knowledge Base