تحميل الأوراق المرئية فقط من ملف Excel

مقدمة

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

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

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

  1. الفهم الأساسي للغة C#: تم تصميم هذا البرنامج التعليمي للمطورين الذين لديهم دراية بلغة البرمجة C#.
  2. Aspose.Cells for .NET: يجب أن يكون لديك مكتبة Aspose.Cells for .NET التي تم تنزيلها وإعدادها. يمكنكتحميل المكتبة هنا.
  3. Visual Studio أو أي IDE: يجب أن يكون لديك IDE حيث يمكنك كتابة واختبار كود C# الخاص بك.
  4. .NET Framework: تأكد من تثبيت .NET Framework اللازم لتشغيل تطبيقاتك.
  5. ملف Excel نموذجي: للتدريب، قم بإنشاء ملف Excel نموذجي أو اتبع التعليمات البرمجية المقدمة. هل جهزت كل شيء؟ رائع! لنبدأ!

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

إحدى الخطوات الأولى في أي مشروع C# يعمل مع Aspose.Cells هي استيراد الحزم المطلوبة. يتيح لك هذا الوصول إلى جميع الوظائف التي توفرها المكتبة. إليك كيفية القيام بذلك:

  1. افتح مشروعك: ابدأ بفتح مشروع C# الخاص بك في Visual Studio أو أي IDE آخر تفضله.
  2. إضافة المراجع: انقر بزر الماوس الأيمن على مشروعك في مستكشف الحلول، ثم حدد “إضافة”، ثم “مرجع”.
  3. ابحث عن Aspose.Cells: حدد موقع ملف Aspose.Cells.dll الذي قمت بتنزيله سابقًا وأضفه إلى مراجع مشروعك. تعتبر هذه الخطوة بالغة الأهمية لأنها تربط وظيفة Aspose.Cells بمشروعك.
using System.IO;
using Aspose.Cells;
using System;

الآن بعد أن قمت باستيراد الحزم اللازمة، سنقوم بإنشاء مصنف Excel نموذجي. في هذا المصنف، سيكون لدينا عدة أوراق، وسيتم إخفاء واحدة منها لهذا البرنامج التعليمي.

الخطوة 1: إعداد البيئة الخاصة بك

أولاً، دعنا نقوم بإعداد البيئة وتحديد المسارات لملف العينة.

// المسار إلى دليل المستندات.
string dataDir = "Your Document Directory";
string sampleFile = "output.xlsx";
string samplePath = dataDir + sampleFile;

في مقتطف التعليمات البرمجية هذا، استبدل"Your Document Directory" مع المسار الفعلي الذي تريد حفظ المصنف الخاص بك فيه.

الخطوة 2: إنشاء المصنف

الآن، لنبدأ بإنشاء المصنف وإضافة بعض البيانات.

// إنشاء مصنف عمل نموذجي
Workbook createWorkbook = new Workbook();
createWorkbook.Worksheets["Sheet1"].Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet2").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet3").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets["Sheet3"].IsVisible = false; // جعل الورقة 3 مخفية
createWorkbook.Save(samplePath);

فيما يلي تفصيل لما يحدث:

  • نحن نقوم بإنشاء مصنف جديد وإضافة ثلاث أوراق.
  • ستكون “الورقة 1” و"الورقة 2" مرئيتين، بينما ستكون “الورقة 3” مخفية.
  • ثم نقوم بحفظ المصنف في المسار المحدد.

الخطوة 3: تحميل مصنف العينة باستخدام خيارات التحميل

الآن بعد أن أصبح لدينا مصنف يحتوي على أوراق مرئية ومخفية، حان الوقت لتحميله مع التأكد من أننا نستطيع الوصول إلى الأوراق المرئية فقط.

LoadOptions loadOptions = new LoadOptions();
loadOptions.LoadFilter = new CustomLoad();

يقوم مقتطف التعليمات البرمجية هذا بإعداد خيارات التحميل للمصنف، والتي سنقوم بتخصيصها لتصفية الأوراق المخفية.

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

لتحميل الأوراق المرئية فقط، نحتاج إلى إنشاء مرشح تحميل مخصص. وإليك كيفية تعريفه:

class CustomLoad : LoadFilter
{
    public override void StartSheet(Worksheet sheet)
    {
        if (sheet.IsVisible)
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.All;
        }
        else
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.Structure;
        }
    }
}
  • الStartSheet تتحقق الطريقة من إمكانية رؤية كل ورقة.
  • إذا كان مرئيًا، فسيتم تحميل كافة البيانات من تلك الورقة.
  • إذا لم يكن مرئيًا، فإنه يتخطى تحميل أي بيانات من تلك الورقة.

الخطوة 5: تحميل المصنف باستخدام خيارات التحميل

الآن دعونا نقوم بتحميل المصنف وعرض البيانات من الأوراق المرئية.

Workbook loadWorkbook = new Workbook(samplePath, loadOptions);
Console.WriteLine("Sheet1: A1: {0}", loadWorkbook.Worksheets["Sheet1"].Cells["A1"].Value);
Console.WriteLine("Sheet2: A1: {0}", loadWorkbook.Worksheets["Sheet2"].Cells["A1"].Value);

يستخدم مقتطف التعليمات البرمجية هذاloadOptions لاستيراد البيانات فقط من الأوراق المرئية وعرض محتوى الخلية A1 من “الورقة 1” و"الورقة 2".

خاتمة

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

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

هل يمكنني تحميل أوراق مخفية إذا لزم الأمر؟

نعم، يمكنك ببساطة تعديل الشروط في مرشح التحميل المخصص لتشمل الأوراق المخفية.

ما هو استخدام Aspose.Cells؟

يستخدم Aspose.Cells للتعامل مع ملفات Excel دون الحاجة إلى تثبيت Microsoft Excel، حيث يوفر وظائف مثل القراءة والكتابة وإدارة أوراق عمل Excel.

هل هناك نسخة تجريبية من Aspose.Cells؟

نعم يمكنكتنزيل نسخة تجريبية مجانية لاختبار ميزاته.

أين يمكنني العثور على الوثائق الخاصة بـ Aspose.Cells؟

الالتوثيق يقدم معلومات شاملة عن كافة الميزات.

كيف يمكنني شراء Aspose.Cells؟

يمكنك بسهولةشراء Aspose.Cells من صفحة الشراء الخاصة بهم.

الاحتفاظ بفواصل للصفوف الفارغة في Excel