الإرشادات التفصيلية: معالجة الأخطاء التي تحدث أثناء إدخال البيانات في عنصر تحكم DataGridView الخاص بـ Windows Forms

معالجة الأخطاء من مخزن البيانات الأساسي ميزة مطلوبة لإدخال بيانات التطبيق. يسهل عنصر تحكم DataGridView الخاص بـ Windows Forms هذه العملية بواسطة كشف حدث DataError, الذي يظهر عند اكتشاف مخزن البيانات حدوث انتهاك في قيد أو قاعدة عمل مقطوعة.

في هذه المعاينة, سيتم استرداد صفوف من جدول Customers في قاعدة بيانات نموذج Northwind وعرضها في عنصر تحكم DataGridView. عندما يتم الكشف عن تكرار قيمة CustomerID في صف جديد أو محرر صف موجودة, سوف يحدث حدث DataError, حدث وستتم معالجته عن طريق عرض MessageBox الذي يوضح الاستثناء.

لنسخ التعليمة البرمجية في هذا الموضوع كقائمة واحدة, راجع كيفية القيام بما يلي: معالجة الأخطاء التي تحدث أثناء إدخال البيانات في عنصر تحكم DataGridView الخاص بـ Windows Forms.

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

لإكمال هذه المعاينة ، سوف تحتاج إلى :

• الاتصال بخادم قاعدة البيانات الذي يحتوي على نموذج Northwind SQL Server.

إنشاء نموذج

لمعالجة أخطاء إدخال البيانات في عنصر تحكم DataGridView

1. إنشاء فئة مشتقة من Form تحتوي على عنصر تحكم DataGridView و مكوّن BindingSource.

   يوفر مثال التعليمات البرمجية التالي التهيئة الأساسية ويتضمين أسلوب Main.

   Imports System
   Imports System.Data
   Imports System.Data.SqlClient
   Imports System.Windows.Forms
   
   Public Class Form1
       Inherits System.Windows.Forms.Form
   
       Private WithEvents dataGridView1 As New DataGridView()
       Private bindingSource1 As New BindingSource()
   
       Public Sub New()
   
           ' Initialize the form.
           Me.dataGridView1.Dock = DockStyle.Fill
           Me.Controls.Add(dataGridView1)
   
       End Sub
   
   
   ...
   
   
       <STAThread()> _
       Shared Sub Main()
           Application.EnableVisualStyles()
           Application.Run(New Form1())
       End Sub
   
   End Class
   

   using System;
   using System.Data;
   using System.Data.SqlClient;
   using System.Windows.Forms;
   
   public class Form1 : System.Windows.Forms.Form
   {
       private DataGridView dataGridView1 = new DataGridView();
       private BindingSource bindingSource1 = new BindingSource();
   
       public Form1()
       {
           // Initialize the form.
           this.dataGridView1.Dock = DockStyle.Fill;
           this.Controls.Add(dataGridView1);
           this.Load += new EventHandler(Form1_Load);
       }
   
   
   ...
   
   
       [STAThread]
       static void Main()
       {
           Application.EnableVisualStyles();
           Application.Run(new Form1());
       }
   
   }
   

2. قم بتنفيذ أسلوب تعريف الفئة في النموذج الخاص بك للتعامل مع تفاصيل الاتصال بقاعدة البيانات.

   يستخدم مثال التعليمات البرمجية هذا أسلوب GetData الذي يقوم بإرجاع كائن DataTable. تأكد من تعيين متغيّر connectionString إلى قيمة مناسبة لقاعدة البيانات الخاصة بك.

   ملاحظة الأمان
   تخزين معلومات حساسة مثل كلمة مرور في سلسلة اتصال يمكن أن يؤثر على أمن التطبيق الخاص بك. استخدام طريقة مصادقة Windows (المعروف أيضا باسم الأمان المتكامل) تعتبر أكثر أماناً للتحكم في الوصول إلى قاعدة بيانات. لمزيد من المعلومات، راجع Protecting Connection Information (ADO.NET).

   Private Shared Function GetData(ByVal selectCommand As String) As DataTable
   
       Dim connectionString As String = _
           "Integrated Security=SSPI;Persist Security Info=False;" + _
           "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096"
   
       ' Connect to the database and fill a data table, including the 
       ' schema information that contains the CustomerID column 
       ' constraint.
       Dim adapter As New SqlDataAdapter(selectCommand, connectionString)
       Dim data As New DataTable()
       data.Locale = System.Globalization.CultureInfo.InvariantCulture
       adapter.Fill(data)
       adapter.FillSchema(data, SchemaType.Source)
   
       Return data
   
   End Function
   

   private static DataTable GetData(string selectCommand)
   {
       string connectionString =
           "Integrated Security=SSPI;Persist Security Info=False;" +
           "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096";
   
       // Connect to the database and fill a data table, including the 
       // schema information that contains the CustomerID column 
       // constraint.
       SqlDataAdapter adapter =
           new SqlDataAdapter(selectCommand, connectionString);
       DataTable data = new DataTable();
       data.Locale = System.Globalization.CultureInfo.InvariantCulture;
       adapter.Fill(data);
       adapter.FillSchema(data, SchemaType.Source);
   
       return data;
   }
   

3. تطبيق معالجة حدث Load للنموذج الخاص بك الذي يقوم بتهيئة DataGridView و BindingSource و تعيين ربط البيانات.

   Private Sub Form1_Load(ByVal sender As System.Object, _
       ByVal e As System.EventArgs) Handles Me.Load
   
       ' Initialize the BindingSource and bind the DataGridView to it.
       bindingSource1.DataSource = GetData("select * from Customers")
       Me.dataGridView1.DataSource = bindingSource1
       Me.dataGridView1.AutoResizeColumns( _
           DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader)
   
   End Sub
   

   private void Form1_Load(System.Object sender, System.EventArgs e)
   {
       // Attach the DataError event to the corresponding event handler.
       this.dataGridView1.DataError +=
           new DataGridViewDataErrorEventHandler(dataGridView1_DataError);
   
       // Initialize the BindingSource and bind the DataGridView to it.
       bindingSource1.DataSource = GetData("select * from Customers");
       this.dataGridView1.DataSource = bindingSource1;
       this.dataGridView1.AutoResizeColumns(
           DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader);
   }
   

4. معالجة حدث DataError في DataGridView.

   إذا كان سياق الخطأ هو عملية تنفيذ, يُعرض الخطأ في MessageBox.

   Private Sub dataGridView1_DataError(ByVal sender As Object, _
       ByVal e As DataGridViewDataErrorEventArgs) _
       Handles dataGridView1.DataError
   
       ' If the data source raises an exception when a cell value is 
       ' commited, display an error message.
       If e.Exception IsNot Nothing AndAlso _
           e.Context = DataGridViewDataErrorContexts.Commit Then
   
           MessageBox.Show("CustomerID value must be unique.")
   
       End If
   
   End Sub
   

   private void dataGridView1_DataError(object sender,
       DataGridViewDataErrorEventArgs e)
   {
       // If the data source raises an exception when a cell value is 
       // commited, display an error message.
       if (e.Exception != null &&
           e.Context == DataGridViewDataErrorContexts.Commit)
       {
           MessageBox.Show("CustomerID value must be unique.");
       }
   }
   

اختبار التطبيق

يمكنك الآن اختبار النموذج للتأكد من أنه يعمل كما هو متوقع.

لاختبار النموذج

• إضغط على F5 لتشغيل التطبيق.

  ستشاهد عنصر تحكم DataGridView تمت معبأ ببيانات جدول العملاء. إذا أدخلت قيمة مكررة لـ CustomerID ثم نفذت التحرير, سيتم إرجاع قيمة الخلية تلقائياً وسوف ترى MessageBox يعرض خطأ إدخال البيانات.

الخطوات التالية

يمنحك هذا التطبيق فهم أساسي لقدرات عنصر تحكم DataGridView. يمكنك تخصيص مظهر وسلوك عنصر تحكم DataGridView بعدة طرق:

• تغيير أنماط الحدود و رأس الصفحة. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تغيير حدود وأنماط خطوط الشبكة في عنصر تحكم DataGridView Windows Forms.

• تمكين أو تقييد مدخلات المستخدم لعنصر تحكم DataGridView. وللمزيد من المعلومات ، راجع كيفية القيام بما يلي: منع إضافة صف والحذف في عرض شبكة البيانات Windows Forms عنصر تحكم و كيفية القيام بما يلي: جعل الأعمدة للقراءة فقط في عنصر تحكم DataGridView Windows Forms .

• التحقق من صحة مدخلات المستخدم لعنصر تحكم DataGridView. لمزيد من المعلومات، راجع الإرشادات التفصيلية: التحقق من صحة بيانات في عرض شبكة بيانات Windows Forms عنصر تحكم.

• معالجة مجموعات كبيرة من البيانات باستخدام الوضع الظاهري. لمزيد من المعلومات، راجع الإرشادات التفصيلية: تطبيق الوضع الظاهري في عرض شبكة البيانات Windows Forms عنصر تحكم.

• تخصيص مظهر الخلايا. للمزيد من المعلومات، راجع كيفية القيام بما يلي: تخصيص مظهر الخلايا الموجودة في عنصر تحكم DataGridView الخاص بـ Windows Forms وكيفية القيام بما يلي: تعيين أنماط خلية عنصر تحكم Windows Forms DataGridView الافتراضي ..

راجع أيضًا:

المهام

كيفية القيام بما يلي: معالجة الأخطاء التي تحدث أثناء إدخال البيانات في عنصر تحكم DataGridView الخاص بـ Windows Forms

الإرشادات التفصيلية: التحقق من صحة بيانات في عرض شبكة بيانات Windows Forms عنصر تحكم

المرجع

DataGridView

BindingSource

المبادئ

Protecting Connection Information (ADO.NET)

موارد أخرى

إدخال البيانات في عنصر تحكم DataGridView Windows Forms