CurrencyManager.SuspendBinding Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
.