CurrencyManager.SuspendBinding Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menangguhkan pengikatan data untuk mencegah perubahan memperbarui sumber data terikat.

public:
 override void SuspendBinding();

public override void SuspendBinding ();

override this.SuspendBinding : unit -> unit

Public Overrides Sub SuspendBinding ()

Contoh

Contoh kode berikut menunjukkan cara menggunakan SuspendBinding metode .

void button3_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   try
   {
      BindingManagerBase^ myBindingManager1 = BindingContext[ myDataSet, "Customers" ];
      myBindingManager1->SuspendBinding();
   }
   catch ( Exception^ ex ) 
   {
      MessageBox::Show( ex->Source );
      MessageBox::Show( ex->Message );
   }
}

private void button3_Click(object sender, EventArgs e)
{
   try
   {
      BindingManagerBase myBindingManager1=BindingContext [myDataSet, "Customers"];
      myBindingManager1.SuspendBinding();
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Source);
      MessageBox.Show(ex.Message);
   }
}

Private Sub button3_Click(sender As Object, e As EventArgs)
   Try
      Dim myBindingManager1 As BindingManagerBase = BindingContext(myDataSet, "Customers")
      myBindingManager1.SuspendBinding()
   Catch ex As Exception
      MessageBox.Show(ex.Source.ToString())
      MessageBox.Show(ex.Message.ToString())
   End Try
End Sub

Keterangan

Metode SuspendBinding dan ResumeBinding memungkinkan penangguhan sementara dan dimulainya kembali pengikatan data dalam skenario pengikatan sederhana. Anda biasanya akan menangguhkan pengikatan data jika pengguna harus melakukan beberapa pengeditan pada bidang data sebelum validasi terjadi. Misalnya, jika satu bidang harus diubah sesuai dengan yang kedua, tetapi jika memvalidasi bidang pertama akan menyebabkan bidang kedua mengalami kesalahan.

Catatan

SuspendBinding mencegah perubahan diterapkan ke sumber data hingga ResumeBinding dipanggil, tetapi tidak benar-benar mencegah peristiwa terjadi. Kontrol yang menggunakan pengikatan data kompleks, seperti DataGridView kontrol, memperbarui nilainya berdasarkan peristiwa perubahan, seperti ListChanged peristiwa. Oleh karena itu, panggilan SuspendBinding tidak akan mencegah kontrol yang terikat kompleks menerima peristiwa untuk memperbarui sumber data. Untuk alasan ini, SuspendBinding dan ResumeBinding dirancang untuk digunakan dengan kontrol terikat sederhana, seperti TextBox kontrol. Atau, Anda dapat menggunakan metode ini dalam skenario pengikatan yang kompleks jika Anda menekan ListChanged peristiwa dengan mengatur properti ke RaiseListChangedEventsfalse.

Lihat juga

• RaiseListChangedEvents
• BindingComplete
• ResumeBinding()
• UpdateIsBinding()
• Bindings