محول Aspose.Cells HTML لـ .NET

Aspose.Cells HTML Converter for .NET enables seamless, high-fidelity conversion between Excel workbooks (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) and HTML/MHTML documents. It exposes a focused API tailored for HTML export and import, ensuring quick integration into any .NET application that requires rendering or embedding spreadsheet content on the web.

التثبيت والإعداد

للبدء، أضف الـ Aspose.Cells for .NET حزمة NuGet إلى مشروعك. راجع الخطوات التفصيلية على الـ التثبيت الصفحة.

بالنسبة للترخيص، يستخدم هذا المكوّن الترخيص القائم على القياس مثل Aspose.Cells؛ راجع الـ الترخيص القائم على القياس الدليل لتفاصيل التكوين.

الميزات والوظائف

الصيغ المدعومة

• Excel إلى HTML: تحويل ملفات Excel (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) إلى HTML أو MHTML متوافق مع المعايير. • HTML إلى Excel: استيراد HTML/MHTML مرة أخرى إلى دفاتر عمل Excel للتحرير ذهابًا وإيابًا.

تحويل عالي الدقة

• يحافظ على تنسيق الخلايا، المناطق المدمجة، الصيغ (كنص)، الصور، المخططات، والأشكال. • تنسيق يعتمد على CSS لضمان مظهر وإحساس متسق عبر صفحات الويب. • إخراج جدول HTML متجاوب لتصميم صديق للهواتف المحمولة.

خيارات التحويل القابلة للتخصيص

• سمات الخلية المخصصة: إضافة سمات HTML مخصصة إلى الخلايا لتعزيز التفاعل وربط البيانات. • تصدير ورقة مختارة: تصدير أوراق عمل محددة بدلاً من دفتر العمل بالكامل. • التحكم في تنسيق التصدير: إنشاء مستندات HTML كاملة أو أجزاء لتضمينها. • التحكم في ترقيم الصفحات: التعامل مع دفاتر العمل متعددة الأوراق مع تنقل مخصص. • معالجة الموارد: تكوين الموارد المضمنة أو الخارجية (الصور، الخطوط، CSS).

معالجة مستندة إلى التدفق

• دعم تدفق الذاكرة: تحويل مباشرة إلى تدفقات الذاكرة للمعالجة داخل الذاكرة. • إدخال/إخراج فعال: واجهات برمجة التطبيقات القائمة على التدفق تقلل من استهلاك الذاكرة. • تكامل تطبيق الويب: إخراج HTML بسلاسة إلى تدفقات استجابة HTTP.

المعالجة الدفعية والأتمتة

• التنقل عبر عدة دفاتر عمل لأتمتة إنشاء HTML بالجملة. • نقاط ربط الأحداث لإدخال HTML أو CSS مخصص أثناء التحويل. • واجهة برمجة تطبيقات آمنة من التعارض تمكّن المعالجة المتوازية.

تحسين الأداء والذاكرة

• واجهات برمجة التطبيقات القائمة على التدفق لكفاءة I/O. • التحميل الكسول لأوراق أو نطاقات محددة للدفاتر الكبيرة. • دعم إخراج HTML مضغوط (GZip) وتجميع الأصول.

التسجيل ومعالجة الأخطاء

• يوفر تشخيصات مفصلة للعناصر غير المدعومة أو الخطوط المفقودة. • استراتيجيات إعادة المحاولة للأخطاء المؤقتة. • تدهور سلس إلى عرض النص العادي عند الحاجة.

التوافق وقابلية التوسعة

• يعمل عبر .NET Framework، .NET Core، و.NET 5/6+. • يمكن دمجه مع Aspose.Cells APIs للتلاعب المتقدم بالبيانات قبل التصدير. • تجميع خفيف الوزن مُحسّن لمهام تحويل HTML.

أمثلة الاستخدام

تحويل أساسي: Excel إلى HTML

أبسط طريقة لتحويل ملف Excel إلى HTML باستخدام سطر واحد من الشيفرة:

using Aspose.Cells.LowCode;
using Aspose.Cells;

string src = "template.xlsx";
HtmlConverter.Process(src, "PluginHtml1.html");

تحويل متقدم مع خيارات مخصصة

ضبط خيارات التحويل لمزيد من التحكم في مخرجات HTML:

using Aspose.Cells.LowCode;
using Aspose.Cells;
using System.IO;
using System.Text;

string src = "template.xlsx";

// Configure load options
LowCodeLoadOptions lclopts = new LowCodeLoadOptions();
lclopts.InputFile = src;

// Configure HTML save options
LowCodeHtmlSaveOptions lcsopts = new LowCodeHtmlSaveOptions();
HtmlSaveOptions htmlOpts = new HtmlSaveOptions();

// Add custom attribute to cells for data binding or JavaScript interaction
htmlOpts.CellNameAttribute = "SpecAddress";

// Export only the first worksheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

lcsopts.HtmlOptions = htmlOpts;

// Output to memory stream for in-memory processing
MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;

// Perform conversion
HtmlConverter.Process(lclopts, lcsopts);

// Verify custom attribute in output
string htmlContent = Encoding.ASCII.GetString(ms.ToArray());
Console.WriteLine(htmlContent.IndexOf("SpecAddress=\"B2\"") > 0 
    ? "Specified attribute has been output" 
    : "Cannot find the expected attribute");

تفصيل الميزة: سمات الخلايا المخصصة

إضافة سمات HTML مخصصة إلى الخلايا لتعزيز التكامل مع الويب:

HtmlSaveOptions htmlOpts = new HtmlSaveOptions();
htmlOpts.CellNameAttribute = "data-cell"; // Cells will have data-cell="A1", data-cell="B2", etc.

حالات الاستخدام:

• معالجة أحداث JavaScript على خلايا محددة
• ربط البيانات في أطر الويب (Angular, React, Vue)
• تنسيق CSS بناءً على عناوين الخلايا
• تحسينات إمكانية الوصول باستخدام سمات ARIA

تفصيل الميزة: تصدير ورقة انتقائي

تصدير أوراق العمل المحددة لتقليل حجم ملف HTML ووقت المعالجة:

// Export only the first sheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

// Export multiple specific sheets
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0, 2, 4 });

حالات الاستخدام:

• صفحات لوحة التحكم التي تعرض أوراق الملخص فقط
• تقارير متعددة الصفحات مع ملفات HTML منفصلة لكل ورقة
• استبعاد الأوراق المخفية أو أوراق الحسابات من العرض على الويب

تفصيل الميزة: الإخراج القائم على التدفق

معالجة التحويلات بالكامل في الذاكرة دون لمس نظام الملفات:

MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;
HtmlConverter.Process(lclopts, lcsopts);

// Use the stream content
byte[] htmlBytes = ms.ToArray();
string htmlString = Encoding.UTF8.GetString(htmlBytes);

حالات الاستخدام:

• واجهات برمجة التطبيقات الويب التي تُعيد محتوى HTML مباشرة
• وظائف سحابية مع تخزين مؤقت
• تخزين مخرجات HTML مؤقتًا في الذاكرة أو Redis
• إنشاء بريد إلكتروني مع بيانات Excel مدمجة

API التقليدي: تحكم كامل

للحالات التي تتطلب أقصى قدر من التحكم، استخدم API دفتر العمل التقليدي:

using Aspose.Cells;

Workbook workbook = new Workbook("Workbook.xlsx");

HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportGridLines = true;
saveOptions.ExportImagesAsBase64 = true;
saveOptions.PresentationPreference = true;

workbook.Save("out.html", saveOptions);

نصائح وأفضل الممارسات

تحسين الأداء

• تصدير انتقائي: استخدم SheetSet لتصدير الأوراق الضرورية فقط وتقليل وقت المعالجة. • واجهات برمجة التطبيقات المستندة إلى التدفق: الاستفادة من تدفقات الذاكرة في تطبيقات الويب لتقليل I/O للقرص. • تحقق من صحة الإدخال: تحقق من حجم ورقة العمل وتعقيدها قبل التحويل لتجنب عنق الزجاجة في الأداء.

جودة الإخراج

• السمات المخصصة: استخدم CellNameAttribute لتحسين تكامل JavaScript وتلاعب DOM. • إدارة الموارد: تكوين الموارد المضمنة مقابل الموارد الخارجية بناءً على سيناريو النشر. • خيارات الضبط الدقيق: الاستفادة HtmlSaveOptions للتحكم في خطوط الشبكة، الصيغ، ومعالجة الصور.

إدارة الذاكرة

• تحرير الموارد: دائمًا قم بلف عمليات التحويل داخل using كتل لإطلاق الموارد بسرعة. • إعادة استخدام التدفق: إعادة ضبط وإعادة استخدام تدفقات الذاكرة للتحويلات الدفعية لتقليل ضغط الـ GC.

نشر الإنتاج

• معالجة الأخطاء: تنفيذ كتل try-catch وتسجيل تحذيرات التحويل لضمان الجودة. • المعالجة الدفعية: تطبيق أنماط المنتج‑المستهلك للتحويلات ذات الحجم الكبير. • استراتيجية التخزين المؤقت: تخزين HTML المُولَّد مؤقتًا بذكاء في تطبيقات الويب الديناميكية. • التحقق من المخرجات: التحقق من أن مخرجات HTML تحتوي على المحتوى المتوقع باستخدام عمليات البحث النصية أو محللات HTML.

المشكلات الشائعة والحلول

ملخص مرجع API

الفئات الرئيسية

• HtmlConverter: فئة ثابتة توفر طرق تحويل مبسطة
• LowCodeLoadOptions: إعدادات تحميل ملفات Excel
• LowCodeHtmlSaveOptions: إعدادات إخراج HTML
• HtmlSaveOptions: إعدادات تحويل HTML التفصيلية
• SheetSet: يحدد أوراق العمل التي سيتم تصديرها

الخصائص الأساسية

• CellNameAttribute: اسم سمة HTML مخصص لتحديد الخلايا
• SheetSet: مصفوفة مؤشرات أوراق العمل للتصدير
• OutputStream: دفق الهدف لإخراج HTML
• InputFile: مسار ملف Excel المصدر