تصدير قيمة سلسلة HTML للخلايا إلى جدول بيانات في Excel

مقدمة

عند العمل مع ملفات Excel في بيئة .NET، قد تجد نفسك في حاجة إلى استخراج المعلومات من الخلايا، ليس فقط كنص عادي ولكن كسلاسل HTML. يمكن أن يكون هذا مفيدًا جدًا عند التعامل مع بيانات نصية غنية أو عندما تريد الحفاظ على التنسيق. في هذا الدليل، سأرشدك خلال تصدير قيمة سلسلة HTML للخلايا إلى جدول بيانات باستخدام Aspose.Cells لـ .NET.

المتطلبات الأساسية

قبل التعمق في الكود، دعنا نتأكد من أن كل ما تحتاجه جاهز. إليك قائمة مراجعة سريعة:

  1. المعرفة الأساسية بلغة C# و.NET: قبل القفز إلى البرمجة، تأكد من أنك على دراية ببرمجة C# وأساسيات إطار عمل .NET.
  2. Aspose.Cells for .NET: إذا لم تقم بتثبيته بالفعل، فأنت بحاجة إلى تثبيت Aspose.Cells for .NET. يمكنك تنزيل نسخة تجريبية مجانية منهنا.
  3. Visual Studio أو IDE الذي تختاره: قم بإعداد بيئتك لكتابة كود C#. يوصى باستخدام Visual Studio نظرًا لنطاقه الواسع من الميزات وسهولة استخدامه.
  4. ملف Excel النموذجي: ستحتاج إلى ملف Excel نموذجي (sampleExportTableAsHtmlString.xlsx) للعمل معه. تأكد من أنه موجود في دليل يمكن الوصول إليه.
  5. مدير الحزم NuGet: تأكد من أن لديك إمكانية الوصول إلى مدير الحزم NuGet في مشروعك لإضافة مكتبة Aspose.Cells بسهولة.

بعد التحقق من هذه المتطلبات الأساسية، دعونا نبدأ في تعلم بعض البرمجة!

استيراد الحزم

قبل أن نتمكن من بدء العمل مع Aspose.Cells، نحتاج إلى استيراد الحزم اللازمة. يتضمن هذا عادةً إضافة حزمة Aspose.Cells NuGet إلى مشروعك. وإليك كيفية القيام بذلك:

افتح مدير الحزم NuGet

في Visual Studio، انقر بزر الماوس الأيمن فوق مشروعك في مستكشف الحلول، ثم حدد إدارة حزم NuGet.

البحث عن Aspose.Cells

في مدير حزمة NuGet، اكتبAspose.Cells في شريط البحث.

تثبيت الحزمة

بمجرد العثور على Aspose.Cells، انقر فوق الزر “تثبيت”. سيؤدي هذا إلى إضافة المكتبة إلى مشروعك والسماح لك باستيرادها في الكود الخاص بك.

استيراد مساحة الاسم

أضف التوجيه التالي في أعلى ملف التعليمات البرمجية الخاص بك:

using System;
using System.IO;
using Aspose.Cells;
using System.Data;

الآن بعد أن قمنا بإعداد كل شيء، دعنا ننتقل إلى العملية خطوة بخطوة لتصدير قيم سلسلة HTML من ملف Excel إلى جدول بيانات.

الخطوة 1: تحديد دليل المصدر

ستبدأ بتحديد الدليل الذي سيتم تخزين ملف Excel الخاص بك فيه. يعد هذا أمرًا بالغ الأهمية لأنه يخبر تطبيقك بمكان العثور على الملف. إليك الكود الخاص بذلك:

string sourceDir = "Your Document Directory";

تأكد من الاستبدال"Your Document Directory" مع المسار الفعلي لملف Excel الخاص بك.

الخطوة 2: تحميل ملف Excel النموذجي

الخطوة التالية هي تحميل مصنف Excel. سوف تستخدمWorkbook يمكنك استخدام الفئة من Aspose.Cells للقيام بذلك. إليك كيفية تحميل الملف:

Workbook wb = new Workbook(sourceDir + "sampleExportTableAsHtmlString.xlsx");

يقوم هذا السطر البسيط من التعليمات البرمجية بتهيئة المصنف وتحميل ملف Excel المحدد.

الخطوة 3: الوصول إلى ورقة العمل الأولى

بمجرد تحميل المصنف، ستحتاج إلى الوصول إلى ورقة العمل المحددة التي تحتوي على البيانات التي تهمك. بشكل عام، ستبدأ بورقة العمل الأولى:

Worksheet ws = wb.Worksheets[0];

هنا، نعمل على ورقة العمل الأولى (المؤشر 0). تأكد من أن بياناتك موجودة في الورقة الصحيحة.

الخطوة 4: تحديد خيارات تصدير الجدول

للتحكم في كيفية تصدير البيانات، تحتاج إلى إعدادExportTableOptionsفي هذه الحالة، تريد التأكد من عدم تصدير أسماء الأعمدة، وتريد تصدير بيانات الخلايا كسلاسل HTML:

ExportTableOptions opts = new ExportTableOptions();
opts.ExportColumnName = false;
opts.ExportAsHtmlString = true;

يسمح لك هذا التكوين بالحفاظ على التنسيق الغني لبيانات الخلية الخاصة بك عند التصدير.

الخطوة 5: تصدير الخلايا إلى جدول البيانات

الآن يأتي الجزء الحاسم حيث يمكنك تصدير البيانات فعليًا. باستخدامExportDataTable الطريقة، يمكنك سحب البيانات من ورقة العمل إلىDataTable. وإليك كيفية القيام بذلك:

DataTable dt = ws.Cells.ExportDataTable(0, 0, 3, 3, opts);

يقوم هذا الكود بتصدير نطاق محدد من الخلايا (من الصف 0، العمود 0 إلى الصف 3، العمود 3) إلى جدول بيانات باستخدام الخيارات المحددة سابقًا.

الخطوة 6: طباعة قيمة السلسلة HTML

أخيرًا، دعنا نطبع قيمة السلسلة HTML من خلية معينة في جدول البيانات لنرى ما تمكنا من تصديره. على سبيل المثال، إذا كنت تريد طباعة القيمة من الصف الثالث والعمود الثاني، فستقوم بما يلي:

Console.WriteLine(dt.Rows[2][1].ToString());

يقوم هذا السطر بطباعة سلسلة HTML المطلوبة من جدول البيانات في وحدة التحكم.

خاتمة

والآن، لقد نجحت في تصدير قيم سلسلة HTML من خلايا في ملف Excel إلى جدول بيانات باستخدام Aspose.Cells for .NET. ولا تعمل هذه الإمكانية على إثراء مهاراتك في معالجة البيانات فحسب، بل إنها تعمل أيضًا على توسيع خياراتك عند التعامل مع المحتوى المنسق مباشرةً من ملفات Excel.

الأسئلة الشائعة

هل يمكنني استخدام Aspose.Cells لتنسيقات ملفات أخرى بالإضافة إلى Excel؟

نعم، Aspose.Cells مخصص في المقام الأول لبرنامج Excel، ولكن Aspose يوفر مكتبات أخرى لتنسيقات مختلفة.

هل أحتاج إلى ترخيص لـ Aspose.Cells؟

نعم، يلزم الحصول على ترخيص صالح للاستخدام الإنتاجي. يمكنك الحصول على ترخيص مؤقتهنا.

ماذا لو كان ملف Excel الخاص بي يحتوي على صيغ؟ هل سيتم تصديرها بشكل صحيح؟

نعم، يمكن لـ Aspose.Cells التعامل مع الصيغ، وعند تصديرها، سيتم تقييمها إلى القيم الناتجة عنها.

هل من الممكن تغيير خيارات التصدير؟

بالتأكيد! يمكنك التخصيصExportTableOptions لتناسب احتياجاتك المحددة.

أين يمكنني العثور على المزيد من الوثائق التفصيلية لـ Aspose.Cells؟

يمكنك العثور على وثائق موسعةهنا.

فرز البيانات في عمود باستخدام قائمة الفرز المخصصة في Excel