مقدمة إلى عنصر التحكم DataRepeater (‏‫Visual Studio)

عنصر تحكم حزم قوة Visual Basic DataRepeater يعتبر بمثابة حاوية لتمرير عناصر التحكم التي تعرض بيانات التكرار ، و على سبيل المثال، الصفوف في جدول قاعدة البيانات. و يمكن استخدامه كبديل لعنصر التحكم DataGridView ، عند الحاجة لتحكم أكثر على تخطيط البيانات . و "يكرر" DataRepeater مجموعة من عناصر التحكم المرتبطة بواسطة إنشاء مثيلات متعددة في طريقة عرض بالتمرير. و يتيح ذلك للمستخدمين عرض سجلات متعددة في نفس الوقت.

نظرة عامة

و في وقت التصميم, عنصر التحكم DataRepeater يتكون من مقطعين. الجزء الخارجي يعتبر منفذ العرض ، حيث يتم عرض بيانات التمرير في وقت التشغيل . القسم (العلوي) الداخلي المعروف بـ قالب العنصر ، هو المكان الذي يوضع فيه عناصر التحكم التي سيتم تكرارها في وقت التشغيل ، و عادةً يكون هناك عنصر تحكم واحد لكل حقل في مصدر البيانات. و يتم تغليف الخصائص و عناصر التحكم الموجودة في قالب العنصر في خاصية ItemTemplate .

في وقت التشغيل ، يُنسخ ItemTemplate إلى كائن DataRepeaterItem الظاهري الذي يتم استخدامه لعرض البيانات عند تمرير كل سجل في العرض. يمكنك تخصيص عرض السجلات الفردية في حدث DrawItem , و على سبيل المثال، تمييز الحقل استناداً إلى القيمة التي يتضمنها. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تغيير مظهر عنصر تحكم DataRepeater (‏‫Visual Studio).

إن الاستخدام الأكثر شيوعاً لعنصر التحكم DataRepeater هو عرض بيانات من جدول قاعدة البيانات أو مصدر بيانات مرتبطة آخر . بالإضافة إلى كائنات البيانات ADO.NET يمكن يربط عنصر التحكم DataRepeater لأي فئة تطبق واجهة IList (بما في ذلك المصفوفة) ، أو أي فئة تطبق واجهة IListSource ، أو أي فئة تطبق الواجهة IBindingList أو أي فئة تطبق الواجهة IBindingListView .

ربط البيانات.

و بشكل عام، يتم إنجاز ربط بيانات عن طريق سحب الحقول من نافذة مصادر البيانات إلى عنصر التحكم DataRepeater . لمزيد من المعلومات، راجع كيفية القيام بما يلي: عرض البيانات المرتبطة في عنصر تحكم DataRepeater (‏‫Visual Studio).

و عند العمل مع كميات كبيرة من بيانات, يمكنك تعيين خاصية VirtualMode إلى True لعرض مجموعة فرعية من البيانات المتوفرة. و يتطلب الوضع الظاهري تطبيق ذاكرة التخزين المؤقت للبيانات من DataRepeater حيث يتم تعبئتها ، و يجب التحكم بكل التفاعلات مع ذاكرة التخزين المؤقت للبيانات في وقت التشغيل . لمزيد من المعلومات، راجع الوضع ظاهري في عنصر تحكم DataRepeater (‏‫Visual Studio).

و يمكنك أيضاً عرض عناصر التحكم غير المنضمة في عنصر التحكم DataRepeater . و على سبيل المثال، يمكنك عرض صورة يتم تكرارها على كل عنصر. لمزيد من المعلومات، راجع كيفية القيام بما يلي: عرض البيانات الغير مرتبطة في عنصر تحكم DataRepeater (‏‫Visual Studio).

أحداث

و الأحداث الأكثر أهمية لعنصر التحكم DataRepeater هي حدث DrawItem ، و الذي يظهر عند تمرير العنصر الجديد في العرض, و هي أيضاً حدث CurrentItemIndexChanged الذي يظهر عند تحديد العنصر . و يمكنك استخدام حدث DrawItem لتغيير مظهر العنصر. و على سبيل المثال، يمكنك تمييز القيم السالبة. استخدم أحداث CurrentItemIndexChanged للوصول إلى قيم عناصر التحكم عند تحديد العنصر.

يكشف عنصر التحكم DataRepeater عن كل أحداث عنصر التحكم القياسية في محرر التعليمات البرمجية. ومع ذلك، بعض الأحداث يجب عدم استخدامها. أحداث لوحة المفاتيح و الماوس مثل KeyDown, و Click، و MouseDown لن تظهر في وقت التشغيل لأن عنصر التحكم DataRepeater نفسه لا يملك تركيز أبداً .

لا يعرض DataRepeaterItem أحداث وقت التصميم لأنه يتم إنشاؤه فقط في وقت تشغيل . و إذا كنت تريد معالجة أحداث لوحة المفاتيح و الماوس يمكنك إضافة عنصر التحكم Panel إلى ItemTemplate في وقت التصميم و معالجة الأحداث لـ Panel. لمزيد من المعلومات، راجع تصحيح أخطاء عنصر التحكم DataRepeater (‏‫Visual Studio).

التخصيصات

و هناك العديد من الطرق لتخصيص مظهر و سلوك عنصر التحكم DataRepeater في كلٍ من وقت التشغيل و وقت التصميم. و يمكن تعيين خصائص لتغيير الألوان أو إخفاء أو تعديل رؤوس العنصر أو تغيير الاتجاه من عمودي إلى أفقي و الكثير الكثير . لمزيد من المعلومات، راجع كيفية القيام بما يلي: تغيير مظهر عنصر تحكم DataRepeater (‏‫Visual Studio) ، كيفية القيام بما يلي: عرض رؤوس العنصر في عنصر التحكم DataRepeater (‏‫Visual Studio) ، و كيفية القيام بما يلي: تغيير تخطيط عنصر التحكم DataRepeater (‏‫Visual Studio).

لاحظ أن بعض الخصائص تتطبق عنصر التحكم DataRepeater نفسه بينما الآخرين تنطبق فقط على ItemTemplate. و تأكد من أن لديك المقطع الصحيح لعنصر التحكم المحدد قبل تعيين الخصائص. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تغيير مظهر عنصر تحكم DataRepeater (‏‫Visual Studio).

و تتضمن التخصيصات الأخرى على القدرة على التحكم في إضافة أو حذف السجلات أو إضافة قدرات البحث و عرض البيانات المرتبطة بالتنسيق الرئيسي و التفصيلي . لمزيد من المعلومات، راجع كيفية القيام بما يلي: تعطيل إضافة و حذف عناصر DataRepeater (‏‫Visual Studio) ، كيفية القيام بما يلي: بحث عن البيانات في عنصر تحكم DataRepeater (‏‫Visual Studio) ، و كيفية القيام بما يلي: إنشاء نموذج رئيسي/تفصيلي عن طريق استخدام عنصرا التحكم DataRepeater (‏‫Visual Studio).

راجع أيضًا:

المهام

الإرشادات التفصيلية: عرض البيانات في عنصر التحكم DataRepeater (‏‫Visual Studio)

تصحيح أخطاء عنصر التحكم DataRepeater (‏‫Visual Studio)

موارد أخرى

عنصر التحكم DataRepeater