BaseDataBoundControl.OnDataBound(EventArgs) Metode

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Memunculkan kejadian DataBound.

protected:
 virtual void OnDataBound(EventArgs ^ e);

protected virtual void OnDataBound (EventArgs e);

abstract member OnDataBound : EventArgs -> unit
override this.OnDataBound : EventArgs -> unit

Protected Overridable Sub OnDataBound (e As EventArgs)

Parameter

e

EventArgs

Objek EventArgs yang berisi data peristiwa.

Contoh

Contoh kode berikut menunjukkan bagaimana OnDataBound metode digunakan untuk menaikkan DataBound peristiwa oleh kelas kontrol terikat data turunan. Setelah menggunakan GetData metode dan PerformDataBinding untuk mengikat data ke kontrol, kontrol terikat data meningkatkan DataBound peristiwa untuk memberi sinyal bahwa pengikatan data selesai. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk DataBoundControl kelas .

protected override void PerformSelect() {            

   // Call OnDataBinding here if bound to a data source using the
   // DataSource property (instead of a DataSourceID), because the
   // databinding statement is evaluated before the call to GetData.       
    if (! IsBoundUsingDataSourceID) {
        OnDataBinding(EventArgs.Empty);
    }            
    
    // The GetData method retrieves the DataSourceView object from  
    // the IDataSource associated with the data-bound control.            
    GetData().Select(CreateDataSourceSelectArguments(), 
        OnDataSourceViewSelectCallback);
    
    // The PerformDataBinding method has completed.
    RequiresDataBinding = false;
    MarkAsDataBound();
    
    // Raise the DataBound event.
    OnDataBound(EventArgs.Empty);
}

Protected Overrides Sub PerformSelect()

    ' Call OnDataBinding here if bound to a data source using the 
    ' DataSource property (instead of a DataSourceID) because the 
    ' data-binding statement is evaluated before the call to GetData.
    If Not IsBoundUsingDataSourceID Then
        OnDataBinding(EventArgs.Empty)
    End If

    ' The GetData method retrieves the DataSourceView object from the 
    ' IDataSource associated with the data-bound control.            
    GetData().Select(CreateDataSourceSelectArguments(), _
        AddressOf OnDataSourceViewSelectCallback)

    ' The PerformDataBinding method has completed.
    RequiresDataBinding = False
    MarkAsDataBound()

    ' Raise the DataBound event.
        OnDataBound(EventArgs.Empty)

End Sub

Keterangan

Metode ini memberi tahu kontrol server bahwa logika pengikatan data apa pun yang terkait dengan kontrol telah selesai.

Penting

Metode DataBind ini disegel pada semua kontrol yang berasal dari BaseDataBoundControl. Kontrol terikat data harus mengambil PerformDataBinding alih-alih DataBind metode untuk mengikat data. Jika DataBind ditimpa, OnDataBinding peristiwa dan OnDataBound dinaikkan tidak berurutan.

Menaikkan peristiwa memanggil penanganan aktivitas melalui delegasi. Untuk informasi selengkapnya, lihat Menangani dan Meningkatkan Peristiwa.

Metode ini OnDataBound juga memungkinkan kelas turunan untuk menangani peristiwa tanpa melampirkan delegasi. Ini adalah teknik yang disukai untuk menangani peristiwa di kelas turunan.

Catatan Bagi Inheritor

Saat mengambil alih di kelas turunan OnDataBound(EventArgs) , pastikan untuk memanggil metode kelas OnDataBound(EventArgs) dasar sehingga delegasi terdaftar menerima peristiwa tersebut.

Lihat juga

• OnDataBinding(EventArgs)