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

مقالة
11/01/2010

توفر هذه المعاينة سيناريو الأساسي من البداية للنهاية لعرض بيانات المرتبطة في عنصر التحكم DataRepeater .

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

تتطلب هذه المعاينة قاعدة بيانات نموذج Northwind.

إذا لم يكن لديك قاعدة البيانات هذه في جهاز كمبيوتر التطوير الخاص بك ، فيمكنك تحميلها من مركز التنزيل لـ Microsoft. للحصول على إرشادات، راجع Downloading Sample Databases (LINQ to SQL).

نظرة عامة

الجزء الأول من هذه المعاينة يتكون من أربعة مهام رئيسية :

إنشاء الحل.
إضافة عنصر التحكم DataRepeater .
إضافة مصدر البيانات.
إضافة عناصر تحكم ربط البيانات.

ملاحظة

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

إنشاء حل DataRepeater

في الخطوة الأولى، تقوم بإنشاء الحل و المشروع.

لإنشاء حل DataRepeater

في ‏‫Visual Studio قائمة ملف ، انقر فوقمشروع جديد.
في جزء أنواع المشروع في صندوق الحوار مشروع جديد ، وسع Visual Basic ، ثم انقر فوقWindows.
في جزء القوالب ، انقر فوقتطبيق Windows Forms.
في مربع الاسم، اكتب X-UA-Compatible.
انقر فوق موافق.

يفتح مصمم Windows Forms .
حدد النموذج في مصمم Windows Forms. في نافذة خصائص عين خاصية الحجم إلى 800 ، 700.

إضافة عنصر التحكم DataRepeater

في هذه الخطوة، يمكنك اضافة عنصر التحكم DataRepeater إلى النموذج .

لإضافة عنصر التحكم DataRepeater

في القائمة عرض، انقر فوق تفاصيل.

ال مربع الأدوات يفتح.
حدد علامة التبويب Visual Basic PowerPacks .
اسحب عنصر التحكم DataRepeater إلى Form1.
في إطار الخصائص, عين خاصية الموقع إلى 0, 25.
قم بتغيير قيمة خاصية**الحجم (Size)**إلى 460, 600.

إضافة مصدر البيانات.

في هذه الخطوة، قم بإضافة مصدر البيانات لعنصر التحكم DataRepeater .

لإضافة مصدر البيانات

في قائمة بيانات ، انقر فوقإظهار مصادر البيانات.
في نافذة مصادر البيانات ، انقر فوقإضافة مصدر بيانات جديد.
حددقاعدة بيانات في صفحة اختر نوع مصدر البيانات و انقر فوق التالي.
في صفحة اختر اتصال البيانات الخاصة بك ، نفذ أحد الخطوات التالية :
- في حالة توفر اتصال بيانات إلى قاعدة بيانات نموذج Northwind في القائمة المنسدلة ، انقر فوقه.
  
  -أو-
- انقر فوقاتصال جديد لتكوين اتصال بيانات جديد . لمزيد من المعلومات، راجع How to: Create Connections to SQL Server Databases.
إذا كانت قاعدة البيانات تتطلب كلمة مرور , حدد الخيار لتضمين بيانات حساسة له ، ثم انقر فوق التالي.

ملاحظة

عند ظهور مربع الحوار، انقر فوق نعم لحفظ الملف إلى المشروع.
انقر فوق التالي في صفحة حفظ سلسلة الاتصال إلى ملف تكوين التطبيق.
قم بتوسيع عقد الجداول في صفحة اختر كائنات قاعدة البيانات الخاصة بك ، .
حدد خانات فحص التالي لـ العملاء و جداول الطلبات ثم انقر فوقإنهاء.

تمت إضافة NorthwindDataSet إلى المشروع و جداول العملاء و الطلبات التي تظهر في نافذة مصادر البيانات .

إضافة عناصر تحكم ربط البيانات.

في هذه الخطوة، تقوم بإضافة عناصر تحكم ربط البيانات إلى DataRepeater.

لإضافة عناصر تحكم ربط البيانات

في نافذة مصادر البيانات , حدد عقدة المستوى الأعلى لجدول العملاء .
تغيير نوع إسقاط الجدول إلى التفاصيل عن طريق النقر فوق تفاصيل في القائمة المنسدلة في عقدة الجدول.
حدد عقدة جدول العملاء و اسحبها إلى منطقة قالب العنصر (المنطقة العلوية) لعنصر التحكم DataRepeater .

تمت إضافة عنصر التحكم BindingNavigator إلى النموذج ، و تمت إضافة مكونات NorthwindDataSet,و CustomersBindingSource,و CustomersTableAdapter, TableAdapterManager و CustomersBindingNavigator إلى مجموعة المكونات.
حدد كل الحقول و التسميات المرتبطة و ضعها بالقرب من الحافة اليسرى من منطقة قالب العنصر .
حدد الخمسة حقول الأخيرة (المنطقة,و الرمز البريدي, Country,و الهاتف و الفاكس) و التسميات المقترنة بها و انقلها إلى الأعلى و إلى يمين الحقول الستة الأولى.
حدد قالب العنصر (المنطقة العليا لعنصر التحكم).
في نافذة خصائص عين خاصية الحجم إلى 427, 170.

في هذه المرحلة ، يكون لديك تطبيق قيد العمل و الذي يقوم بعرض قائمة العملاء المكررة. و يمكنك الضغط على F5 لتشغيل التطبيق أو تغيير البيانات و إضافة أو حذف سجلات العملاء.

في الخطوة التالية الاختيارية ستتعلم كيفية تخصيص عنصر التحكم DataRepeater .

الخطوات التالية (اختياري)

يتكون هذا الجزء من المعاينة من أربع مهام اختيارية :

تغيير المظهر لعنصر التحكم DataRepeater
منع المستخدمين من إضافة أو حذف السجلات.
إضافة قدرة بحث إلى عنصر التحكم DataRepeater .
إضافة شكل رئيسي و جدول التفاصيل إلى عنصر التحكم DataRepeater .

تغيير المظهر لعنصر التحكم DataRepeater

في هذه الخطوة الاختيارية ، تقوم بتغيير BackColor لعنصر التحكم DataRepeater في وقت التصميم. و يمكنك أيضاً إضافة التعليمات البرمجية لعرض صفوف بألوان مغيرة و لتغيير تسمية ForeColor حسب الحالة.

لتغيير مظهر عنصر التحكم

في مصمم Windows Forms ، حدد المنطقة (السفلى) الرئيسية لعنصر التحكم DataRepeater .
في نافذة الخصائص ، قم بتعيين خاصية BackColor إلى أبيض .
انقر مزودجاً فوقDataRepeater لفتح محرر التعليمات البرمجية .
في محرر التعليمات البرمجية في قائمة الحدث المنسدلة ، انقر فوق DrawItem.

في معالج الحدث DrawItem ، أضف التعليمات البرمجية التالية لتبديل BackColor :

' Alternate the back color.
If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
    ' Apply the secondary back color.
    e.DataRepeaterItem.BackColor = Color.AliceBlue
Else
    ' Apply the default back color.
    e.DataRepeaterItem.BackColor = DataRepeater1.BackColor
End If

// Alternate the back color.
if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
// Apply the secondary back color.
{
    e.DataRepeaterItem.BackColor = Color.AliceBlue;
}
else
{
    // Apply the default back color.
    e.DataRepeaterItem.BackColor = dataRepeater1.BackColor;
}

في معالج الحدث DrawItem ، قم بإضافة التعليمات البرمجية التالية لتغيير ForeColor لبطاقة العنونة استناداً إلى الشرط :

If e.DataRepeaterItem.Controls(RegionTextBox.Name).Text = "" Then
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Red
Else
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Black
End If

if (e.DataRepeaterItem.Controls[regionTextBox.Name].Text == "")
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Red;
}
else
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Black;
}

اضغط F5 لتشغيل التطبيق و مشاهدة التخصيص .

منع المستخدمين من إضافة أو حذف السجلات.

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

لمنع المستخدمين من إضافة و حذف السجلات

في مصمم Windows Forms انقر نقر مزدوج فوق النموذج لفتح محرر التعليمات البرمجية.

قم بإضافة التعليمات البرمجية التالية إلى حدث Form_Load .

DataRepeater1.AllowUserToAddItems = False
DataRepeater1.AllowUserToDeleteItems = False
BindingNavigatorAddNewItem.Enabled = False
CustomersBindingSource.AllowNew = False
BindingNavigatorDeleteItem.Enabled = False

dataRepeater1.AllowUserToAddItems = false;
dataRepeater1.AllowUserToDeleteItems = false;
bindingNavigatorAddNewItem.Enabled = false;
customersBindingSource.AllowNew = false;
bindingNavigatorDeleteItem.Enabled = false;

في القائمة المنسدلة لاسم الفئة , انقر فوق BindingNavigatorDeleteItem. في القائمة المنسدلة لاسم الأسلوب ، انقر فوق EnabledChanged.
قم بإضافة التعليمات البرمجية التالية إلى معالج الحدث BindingNavigatorDeleteItem_EnabledChanged :
```
If BindingNavigatorDeleteItem.Enabled = True Then
    BindingNavigatorDeleteItem.Enabled = False
End If
```
```
if (bindingNavigatorDeleteItem.Enabled == true)
{
    bindingNavigatorDeleteItem.Enabled = false;
}
```
ملاحظة

هذه الخطوة غير ضرورية لأن BindingSource سيتيح زر DeleteItem في كل مرة يتم فيها تغيير السجل الحالي.
إضغط على F5 لتشغيل التطبيق. و لاحظ أن زر DeleteItem معطّل و لا يمكنك حذف العناصر عن طريق الضغط على مفتاح الحذف DELETE .

إضافة قدرة البحث إلى عنصر التحكم DataRepeater .

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

لإضافة إمكانية البحث

اسحب عنصر التحكم TextBox من مربع الأدوات إلى النموذج الذي يحتوي على عنصر التحكم DataRepeater .

ضعها تحت عنصر التحكم DataRepeater .
في نافذة الخصائص, غير خاصية الاسم إلى SearchTextBox .
اسحب عنصر التحكم Button من مربع الأدوات إلى النموذج الذي يحتوي على عنصر التحكم DataRepeater . ضعها تحت عنصر التحكم DataRepeater .
في نافذة الخصائص, غير خاصية الاسم إلى SearchButton. تغيير خاصية النص إلى بحث .

انقر نقراً مزودجاً فوق عنصر التحكم Button لفتح محرر التعليمات البرمجية ثم قم بإضافة التعليمات البرمجية التالية إلى معالج الحدث SearchButton_Click .

Dim foundIndex As Integer
Dim searchString As String
searchString = SearchTextBox.Text
' Search for the string in the CustomerID field.
foundIndex = CustomersBindingSource.Find("CustomerID",
 searchString)
If foundIndex > -1 Then
    DataRepeater1.CurrentItemIndex = foundIndex
Else
    MsgBox("Item " & searchString & " not found.")
End If

int foundIndex;
string searchString;
searchString = searchTextBox.Text;
// Search for the string in the CustomerID field.
foundIndex = customersBindingSource.Find("CustomerID", searchString);
if (foundIndex > -1)
{
    dataRepeater1.CurrentItemIndex = foundIndex;
}
else
{
    MessageBox.Show("Item " + searchString + " not found.");
}

إضغط على F5 لتشغيل التطبيق. اكتب هوية العميل في SearchTextBox ثم انقر فوق زر بحث .

إضافة شكل رئيسي و جدول التفاصيل إلى عنصر التحكم DataRepeater .

في هذه الخطوة الاختيارية أضف عنصر التحكم DataRepeater الثاني لعرض الطلبات ذات الصلة لكل عميل .

لإضافة جدول رئيسي و جدول تفصيلي

اسحب عنصر التحكم DataRepeater الثاني من علامة تبويب PowerPacks Visual Basic في مربع الأدوات إلى النموذج.
في إطار الخصائص, عين خاصية الموقع إلى 465, 25.
قم بتغيير قيمة خاصية**الحجم (Size)**إلى 315, 600.
في نافذة مصادر البيانات وسع عقدة جدول العملاء و حدد جدول الطلبات .
تغيير نوع إسقاط جدول الطلبات عن طريق النقر فوق تفاصيل في القائمة المنسدلة في عقدة الجدول.
اسحب عقدة جدول الطلبات إلى منطقة قالب العنصر (المنطقة العلوية) من عنصر التحكم DataRepeater الثاني .

مكون OrdersBindingSource و مكونOrdersTableAdapter تمت إضافتهم إلى مجموعة المكونات .
إضغط على F5 لتشغيل التطبيق. عند تحديد كل عميل في أول عنصر التحكم DataRepeater ، فإن الطلبات لذلك العميل التي يتم عرضها في عنصر التحكم DataRepeater الثاني .