المتابعون للمدونة

الجمعة، 26 مايو 2017

ITableMappingCollection Interface


 واجهة مجموعة خرائط الجداول
ITableMappingCollection Interface

هذه الواجهة ترث واجهة القائمة IList، وهي قائمة تحتوي على خرائط الجداول.
وإضافة إلى ما ترثه من واجهة القائمة من عناصر، تمتلك الوسيلة الوحيدة التالية: 

 معرفة الخريطة من جدول مجموعة البيانات GetByDataSetTable:
أرسل إلى هذه الوسيلة اسم جدول موجود في مجموعة البيانات DataSet، لتعيد إليك كائنا يمثل الواجهة ITableMapping، يحتوي على خريطة هذا الجدول.. ومن المتوقع أن يكون هذا الكائن من نوع الفئة DataTableMapping. 

كما تضيف هذه الواجهة صيغة أخرى لبعض عناصر القائمة التقليدية، مثل: 

 العنصر Item:
تستقبل الصيغة الثانية لهذه الخاصية اسم الجدول الأصلي (وهو حساس لحالة الأحرف)، وتعيد كائنا Object يحتوي على خريطة هذا الجدول إن وجدت في القائمة، وإن لم توجد فسيحدث خطأ.
كما يمكنك استخدام هذه الخاصية لتغيير كائن خريطة الجدول، فهي قابلة للقراءة وللكتابة أيضا. 

 إضافة Add:
تستقبل الصيغة الثانية لهذه الوسيلة معاملين نصيين Strings، أولها هو اسم الجدول الأصلي (وهو حساس لحالة الأحرف Case-Sensitive)، وثانيهما هو اسم الجدول في مجموعة البيانات.. وتقوم هذه الوسيلة بإنشاء كائن خريطة جدول DataTableMapping يمثل العلاقة بين الجدولين وتضيفه إلى القائمة، وتعيد نسخة من الواجهة ITableMapping تشير إلى هذا الكائن. 

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

 رقم العنصر IndexOf:
تستقبل الصيغة الثانية لهذه الوسيلة اسم الجدول الأصلي، وتعيد رقم الخانة التي يوجد بها كائن خريطة هذا الجدول في القائمة إن وجد، أو تعيد -1 إن لم توجد خريطة لهذا الجدول. 

 حذف من موضع RemoveAt:
تستقبل الصيغة الثانية لهذه الوسيلة اسم الجدول الأصلي، وتبحث في القائمة عن كائن خريطة هذا الجدول، وتحذفه إن وجدته.

ملحوظة:
هذه الصيغة تبدو مختلفة في وظيفتها عن الصيغة الأولى المألوفة، التي تستقبل رقم خانة في القائمة وتحذفها لإزالة خريطة الجدول الموجودة بها من القائمة.. وإن شئت رأيي، كان المنطقي أن تكون هذه الصيغة الجديدة هي الصيغة الثانية للوسيلة Remove وليس RemoveAt منعا للالتباس!!

من كتاب: من الصفر إلى الاحتراف برمجة قواعد البيانات في فيجوال بيزيك دوت نت ADO .NET.. للتنزيل:

 

ليست هناك تعليقات:

إرسال تعليق

ملحوظة: يمكن لأعضاء المدونة فقط إرسال تعليق.

صفحة الشاعر