استعلام عن مناطق الخلايا المرسومة على مسار خريطة Xml باستخدام Aspose.Cells
مقدمة
هل تساءلت يومًا عن كيفية التعامل مع بيانات XML في Excel باستخدام .NET؟ باستخدام Aspose.Cells for .NET، وهي مكتبة قوية للتعامل مع جداول البيانات، يمكنك بسهولة التفاعل مع خرائط XML داخل ملفات Excel الخاصة بك. تخيل أن لديك ملف Excel مملوءًا بالبيانات المنظمة، وتحتاج إلى الاستعلام عن مناطق معينة مُعيَّنة لمسارات XML—وهنا تبرز Aspose.Cells. في هذا البرنامج التعليمي، سنتعمق في الاستعلام عن مناطق الخلايا المُعيَّنة لمسارات خريطة XML في ملفات Excel باستخدام Aspose.Cells for .NET. سواء كنت تتطلع إلى إنشاء تقارير ديناميكية أو أتمتة استخراج البيانات، فإن هذا الدليل يغطيك بإرشادات خطوة بخطوة.
المتطلبات الأساسية
قبل أن ننتقل إلى البرمجة، هناك بعض الأشياء التي ستحتاجها:
- Aspose.Cells for .NET: تأكد من تثبيت هذه المكتبة. يمكنك تنزيلهاهنا أو احصل عليه عبر NuGet.
- ملف Excel مُصمم بصيغة XML: بالنسبة لهذا البرنامج التعليمي، ستحتاج إلى ملف Excel (.xlsx) يحتوي على خريطة XML.
- بيئة التطوير: يفترض هذا الدليل أنك تستخدم Visual Studio، ولكن أي محرر C# يجب أن يعمل بشكل جيد.
- ترخيص Aspose: يمكنك استخدام ترخيص مؤقت إذا لزم الأمر، والذي يمكنك الحصول عليههنا.
استيراد الحزم
للبدء، تأكد من استيراد المساحات الأساسية الضرورية في ملف الكود الخاص بك:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Diagnostics;
using System.Collections;
باستخدام هذه الحزم، ستكون جاهزًا للوصول إلى المصنف، ومعالجة أوراق العمل، والاستعلام عن خرائط XML داخل جدول البيانات.
الخطوة 1: تحميل ملف Excel الذي يحتوي على خريطة XML
أولاً، ستحتاج إلى تحميل ملف Excel يحتوي بالفعل على تعيين XML. يعمل هذا الملف كمصدر للبيانات.
// تحديد مسارات الدليل للمصدر والمخرجات
string sourceDir = "Your Document Directory";
// تحميل ملف Excel
Workbook wb = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");
هنا،Workbook هي الفئة التي تمثل ملف Excel بالكامل، والذي تقوم بتحميله باستخدام مسار الملف. استبدل"Your Document Directory" مع مسار الدليل الفعلي الذي يقع فيه ملفك.
الخطوة 2: الوصول إلى خريطة XML في المصنف
بمجرد تحميل الملف، تكون الخطوة التالية هي الوصول إلى خريطة XML داخل المصنف. تعمل هذه الخريطة كجسر بين جدول البيانات وبيانات XML.
//الوصول إلى أول خريطة XML في المصنف
XmlMap xmap = wb.Worksheets.XmlMaps[0];
هنا، نقوم باسترجاع أول خريطة XML في المصنف من خلال الوصول إلىXmlMaps[0] منWorksheets يمكنك الحصول على عدة خرائط XML في مصنف، ويركز هذا البرنامج التعليمي على الخريطة الأولى.
الخطوة 3: الوصول إلى ورقة العمل للاستعلام
بعد أن أصبحت خريطة XML جاهزة، ستحتاج الآن إلى تحديد ورقة العمل المحددة التي توجد بها البيانات المرسومة. عادةً ما تكون هذه هي ورقة العمل الأولى، لكن الأمر يعتمد على إعداد الملف.
// الوصول إلى ورقة العمل الأولى في المصنف
Worksheet ws = wb.Worksheets[0];
يتيح لك الوصول إلى ورقة العمل التي تحتوي على البيانات المرسومة بتنسيق XML استهداف خلايا معينة. هنا، نستخدم ورقة العمل الأولى، ولكن يمكنك اختيار أي ورقة عمل أخرى عن طريق تغيير الفهرس أو تحديد الاسم.
الخطوة 4: الاستعلام عن خريطة XML باستخدام مسار
الآن يأتي الجزء الأساسي: الاستعلام عن خريطة XML. هنا، ستحدد مسار XML وتسترد البيانات المخصصة لهذا المسار داخل ورقة العمل.
Console.WriteLine("Query Xml Map from Path - /MiscData");
ArrayList ret = ws.XmlMapQuery("/MiscData", xmap);
الXmlMapQueryتأخذ الطريقة معامِلين - مسار XML وخريطة XML التي استردتها سابقًا. في هذا المثال، نقوم باستعلام المسار/MiscData ، وهو المسار الأعلى مستوى في بنية XML. يتم تخزين النتائج فيArrayList، مما يجعل من السهل تكرارها.
الخطوة 5: عرض نتائج الاستعلام
بعد الاستعلام عن البيانات، تكون الخطوة التالية هي عرض النتائج. دعنا نطبع كل عنصر منArrayList إلى وحدة التحكم للحصول على رؤية واضحة للبيانات التي تم استخراجها.
// طباعة نتائج الاستعلام
for (int i = 0; i < ret.Count; i++)
{
Console.WriteLine(ret[i]);
}
تمر هذه الحلقة عبر كل عنصر فيArrayList وتطبعها على وحدة التحكم. سترى البيانات المستخرجة من مسار خريطة XML/MiscData.
الخطوة 6: الاستعلام عن مسار XML المتداخل
لتحسين استعلامك، دعنا ننتقل إلى مسار متداخل داخل بنية XML، مثل/MiscData/row/Color.
Console.WriteLine("Query Xml Map from Path - /MiscData/row/Color");
ret = ws.XmlMapQuery("/MiscData/row/Color", xmap);
هنا، نقوم بالاستعلام عن مسار أكثر تحديدًا داخل بيانات XML. من خلال تضييق نطاق البحث إلى/MiscData/row/Color ، يمكنك استهداف معلومات اللون فقط أسفلrow عقدة في بنية XML.
الخطوة 7: عرض نتائج استعلام المسار المتداخل
أخيرًا، قد ترغب في طباعة نتائج هذا الاستعلام المكرر لرؤية القيم المحددة التي تم تعيينها إلى/MiscData/row/Color.
// طباعة نتائج استعلام المسار المتداخل
for (int i = 0; i < ret.Count; i++)
{
Console.WriteLine(ret[i]);
}
تمامًا كما في السابق، تقوم هذه الحلقة بإخراج نتائج الاستعلام إلى وحدة التحكم، مما يسمح لك بمراجعة البيانات المحددة التي تم جلبها من مسار XML المتداخل.
خاتمة
والآن لديك كل ما تحتاج إليه! باستخدام Aspose.Cells لـ .NET، أصبح الاستعلام عن مناطق الخلايا المخصصة لمسارات خريطة XML أمرًا بسيطًا وفعالًا للغاية. هذه الميزة القوية هي بمثابة تغيير جذري للمطورين الذين يحتاجون إلى استخراج بيانات XML محددة من جداول البيانات. لديك الآن الأساس لتنفيذ استعلامات XML أكثر تعقيدًا وحتى الجمع بين تعيينات XML المتعددة داخل سير عمل Excel. هل أنت مستعد للمضي قدمًا في هذا الأمر؟ استكشف وثائق Aspose.Cells للحصول على وظائف خريطة XML إضافية لتحسين تطبيقاتك!
الأسئلة الشائعة
هل يمكنني تعيين ملفات XML متعددة في مصنف Excel واحد؟
نعم، يسمح لك Aspose.Cells بإدارة خرائط XML متعددة في مصنف، مما يتيح تفاعلات البيانات المعقدة.
ماذا يحدث إذا لم يكن مسار XML موجودًا في الخريطة؟
إذا كان المسار غير صالح أو غير موجود،XmlMapQuery ستعيد الطريقة قيمة فارغةArrayList.
هل أحتاج إلى ترخيص لاستخدام Aspose.Cells لـ .NET؟
نعم، يلزم الحصول على ترخيص للاستفادة من الوظائف الكاملة. يمكنك تجربةنسخة تجريبية مجانيةأو الحصول علىرخصة مؤقتة.
هل يمكنني حفظ البيانات المستفسر عنها في ملف Excel جديد؟
بالتأكيد! يمكنك استخراج البيانات التي تم الاستعلام عنها وكتابتها في ملف Excel آخر أو أي تنسيق آخر يدعمه Aspose.Cells.
هل من الممكن الاستعلام عن خرائط XML بتنسيقات أخرى غير Excel (.xlsx)؟
يتم دعم تعيين XML في ملفات .xlsx. بالنسبة للتنسيقات الأخرى، قد تكون الوظيفة محدودة أو غير مدعومة.
