Control.DataBind Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya.

Overload

DataBind()	Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya.
DataBind(Boolean)	Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.

DataBind()

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya.

public:
 virtual void DataBind();

public virtual void DataBind ();

abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit

Public Overridable Sub DataBind ()

Contoh

Contoh berikut mengambil alih DataBind metode dalam kontrol server ASP.NET kustom. Ini dimulai dengan memanggil metode dasar OnDataBinding dan kemudian menggunakan ControlCollection.Clear metode untuk menghapus semua kontrol anak dan ClearChildViewState metode untuk menghapus pengaturan status tampilan yang disimpan untuk kontrol anak tersebut. Terakhir, ChildControlsCreated properti diatur ke true dan kontrol diinstruksikan untuk melacak perubahan apa pun pada status tampilan kontrol yang baru dibuat dengan TrackViewState metode . Ini adalah teknik umum saat mengikat data ke kontrol untuk memastikan bahwa data baru tidak bertentangan dengan data yang disimpan dari panggilan metode sebelumnya DataBind .

public override void DataBind() 
{
   base.OnDataBinding(EventArgs.Empty);
   // Reset the control's state.
   Controls.Clear();
   // Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   if (HasChildViewState)
      ClearChildViewState();
   ChildControlsCreated = true;
   if (!IsTrackingViewState)
      TrackViewState();
}

Public Overrides Sub DataBind()
   MyBase.OnDataBinding(EventArgs.Empty)
   ' Reset the control's state.
   Controls.Clear()
   ' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   If HasChildViewState Then
      ClearChildViewState()
   End If
   ChildControlsCreated = True
   If Not IsTrackingViewState Then
      TrackViewState()
   End If
End Sub

Keterangan

Gunakan metode ini untuk mengikat data dari sumber ke kontrol server. Metode ini umumnya digunakan setelah mengambil himpunan data melalui kueri database. Sebagian besar kontrol melakukan pengikatan data secara otomatis, yang berarti Anda biasanya tidak perlu memanggil metode ini secara eksplisit.

Metode ini biasanya ditimpa ketika Anda membuat kontrol terikat data templat kustom. Untuk informasi selengkapnya, lihat Cara: Membuat Templat ASP.NET Kontrol Pengguna dan Mengembangkan Kontrol Server Web Data-Bound Kustom. Ketika dipanggil pada kontrol server, metode ini menyelesaikan semua ekspresi pengikatan data dalam kontrol server dan di salah satu kontrol turunannya.

Lihat juga

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Mengembangkan Kontrol Server ASP.NET Kustom
• Ringkasan Siklus Hidup Halaman ASP.NET

DataBind(Boolean)

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.

protected:
 virtual void DataBind(bool raiseOnDataBinding);

protected virtual void DataBind (bool raiseOnDataBinding);

abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit

Protected Overridable Sub DataBind (raiseOnDataBinding As Boolean)

Parameter

raiseOnDataBinding

Boolean

true DataBinding jika peristiwa dimunculkan; jika tidak, false.

Keterangan

Control.DataBind(Boolean) Gunakan metode dalam skenario saat kontrol kustom Anda mengambil DataBind alih metode dan mengimplementasikan IDataItemContainer antarmuka. Dalam skenario ini, kontrol kustom memanggil Control.DataBind(Boolean) metode dengan raiseOnDataBinding diatur ke false untuk memastikan bahwa metode kelas DataBind dasar dipanggil.

Metode memanggil Control.DataBind() metode dengan raiseOnDataBinding diatur ke true.Control.DataBind(Boolean)

Catatan

Memanggil Control.DataBind(Boolean) metode dengan raiseOnDataBinding diatur untuk false menyebabkan kontrol anak terikat data dengan Control.DataBind() metode .

Lihat juga

• DataBinding
• DataBindChildren()
• Ringkasan Siklus Hidup Halaman ASP.NET