Memvalidasi data saat baris baru ditambahkan ke kontrol ListObject

Pengguna dapat menambahkan baris baru ke ListObject kontrol yang terikat ke data. Anda dapat memvalidasi data pengguna sebelum melakukan perubahan pada sumber data.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk Excel. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Validasi Data

Setiap kali baris ditambahkan ke ListObject yang terikat ke data, BeforeAddDataBoundRow peristiwa akan dinaikkan. Anda dapat menangani kejadian ini untuk melakukan validasi data Anda. Misalnya, jika aplikasi Anda mengharuskan hanya karyawan berusia antara 18 dan 65 tahun yang dapat ditambahkan ke sumber data, verifikasi bahwa usia yang dimasukkan termasuk dalam rentang tersebut sebelum baris ditambahkan.

Catatan

Anda harus selalu memeriksa input pengguna di server selain klien. Untuk informasi selengkapnya, lihat Mengamankan aplikasi klien.

Untuk memvalidasi data saat baris baru ditambahkan ke ListObject terikat data

1. Buat variabel untuk ID dan DataTable di tingkat kelas.

   C#

   private int id = 0;
   private System.Data.DataTable employeeTable;
   

   VB

   Dim id As Integer = 0
   Dim employeeTable As System.Data.DataTable
   

2. Buat kolom dan data sampel baru DataTable dan tambahkan di Startup penanganan Sheet1 aktivitas kelas (dalam proyek tingkat dokumen) atau ThisAddIn kelas (dalam proyek Add-in VSTO).

   C#

   employeeTable = new System.Data.DataTable("Employees");
   
   System.Data.DataColumn column = employeeTable.Columns.Add
       ("Id", typeof(int));
   column.AllowDBNull = false;
   
   employeeTable.Columns.Add("FirstName", typeof(string));
   employeeTable.Columns.Add("LastName", typeof(string));
   employeeTable.Columns.Add("Age", typeof(int));
   
   employeeTable.Rows.Add(id, "Nancy", "Anderson", "56");
   employeeTable.Rows.Add(id, "Robert", "Brown", "44");
   id++;
   
   list1.SetDataBinding(employeeTable, "", "FirstName", "LastName", "Age");
   
   list1.BeforeAddDataBoundRow +=new Microsoft.Office.Tools.Excel.
       BeforeAddDataBoundRowEventHandler(list1_BeforeAddDataBoundRow);
   

   VB

   employeeTable = New System.Data.DataTable("Employees")
   
   Dim column As System.Data.DataColumn = _
       employeeTable.Columns.Add("Id", GetType(Int32))
   column.AllowDBNull = False
   
   employeeTable.Columns.Add("FirstName", GetType(String))
   employeeTable.Columns.Add("LastName", GetType(String))
   employeeTable.Columns.Add("Age", GetType(Int32))
   
   employeeTable.Rows.Add(id, "Nancy", "Anderson", 56)
   employeeTable.Rows.Add(id, "Robert", "Brown", 44)
   id += 1
   
   list1.SetDataBinding(employeeTable, "", "FirstName", "LastName", "Age")
   

3. Tambahkan kode ke list1_BeforeAddDataBoundRow penanganan aktivitas untuk memeriksa apakah usia yang dimasukkan termasuk dalam rentang yang dapat diterima.

   C#

   private void list1_BeforeAddDataBoundRow(object sender,
       Microsoft.Office.Tools.Excel.BeforeAddDataBoundRowEventArgs e)
   {
       System.Data.DataRow row = ((System.Data.DataRowView)e.Item).Row;
   
       if (row["Age"] != null && row["Age"] != Convert.DBNull)
       {
           int ageEntered = (int)row["Age"];
   
           if (ageEntered < 21 || ageEntered > 65)
           {
               System.Windows.Forms.MessageBox.Show
                   ("Age must be between 21 and 65. The row cannot be added.");
               e.Cancel = true;
               return;
           }
           row["ID"] = id;
           id++;
       }
       else
       {
           System.Windows.Forms.MessageBox.Show("You must enter an age.");
           e.Cancel = true;
       }
   }
   

   VB

   Private Sub list1_BeforeAddDataBoundRow(ByVal sender As Object, ByVal e As  _
       Microsoft.Office.Tools.Excel.BeforeAddDataBoundRowEventArgs) _
       Handles list1.BeforeAddDataBoundRow
   
       Dim row As System.Data.DataRow = (CType(e.Item, System.Data.DataRowView)).Row
   
       If Not row("Age") Is Nothing And Not row("Age") Is Convert.DBNull Then
   
           Dim ageEntered As Integer = CType(row("Age"), Int32)
   
           If ageEntered < 21 Or ageEntered > 65 Then
               System.Windows.Forms.MessageBox.Show _
                   ("Age must be between 21 and 65. The row cannot be added.")
               e.Cancel = True
               Return
           End If
   
           row("ID") = id
           id += 1
   
       Else
           System.Windows.Forms.MessageBox.Show("You must enter an age.")
           e.Cancel = True
       End If
   End Sub
   

Mengkompilasi kode

Contoh kode ini mengasumsikan bahwa Anda memiliki nama list1 yang sudah ada ListObject pada lembar kerja tempat kode ini muncul.

Konten terkait

• Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses
• Kontrol pada dokumen Office
• Menambahkan kontrol ke dokumen Office pada waktu proses
• Kontrol ListObject
• Mengotomatiskan Excel dengan menggunakan objek yang diperluas
• Cara: Memetakan kolom ListObject ke data