Control.DataBind Yöntem

Tanım

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

Aşırı Yüklemeler

DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

C#
public virtual void DataBind();

Örnekler

Aşağıdaki örnek, özel bir ASP.NET sunucu denetiminde yöntemini geçersiz kılar DataBind . Temel OnDataBinding yöntemi çağırarak başlar ve ardından yöntemini kullanarak tüm alt denetimleri ve bu alt denetimlerin ClearChildViewState kaydedilmiş görünüm durumu ayarlarını silme yöntemini kullanırControlCollection.Clear. Son olarak, ChildControlsCreated özelliği olarak ayarlanır true ve denetime yeni oluşturulan denetimlerin görünüm durumundaki değişiklikleri yöntemiyle izlemesi TrackViewState istenir. Bu, yeni verilerin önceki DataBind yöntem çağrısından depolanan verilerle çakışmadığından emin olmak için verileri bir denetime bağlarken kullanılan yaygın bir tekniktir.

C#
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();
}

Açıklamalar

Bir kaynaktan sunucu denetimine veri bağlamak için bu yöntemi kullanın. Bu yöntem genellikle veritabanı sorgusu aracılığıyla bir veri kümesi alındıktan sonra kullanılır. Çoğu denetim veri bağlamayı otomatik olarak gerçekleştirir; bu da genellikle bu yöntemi açıkça çağırmanız gerekmediği anlamına gelir.

Özel bir şablonlu veriye bağlı denetim oluşturduğunuzda bu yöntem genellikle geçersiz kılınabilir. Daha fazla bilgi için bkz . Nasıl yapılır: Kullanıcı Denetimleri ASP.NET Şablon oluşturma ve Özel Data-Bound Web Sunucusu Denetimleri Geliştirme. Bir sunucu denetiminde çağrıldığında, bu yöntem sunucu denetiminde ve alt denetimlerinden herhangi birinde tüm veri bağlama ifadelerini çözümler.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

C#
protected virtual void DataBind(bool raiseOnDataBinding);

Parametreler

raiseOnDataBinding
Boolean

true DataBinding olay tetiklenmişse; aksi takdirde , false.

Açıklamalar

Control.DataBind(Boolean) Özel denetiminiz yöntemi geçersiz kılıp DataBind arabirimini uyguladığında IDataItemContainer bir senaryoda yöntemini kullanın. Bu senaryoda özel denetim, temel sınıfın DataBind yönteminin Control.DataBind(Boolean) çağrıldığından emin olmak için false set ile raiseOnDataBinding yöntemini çağırır.

Control.DataBind() yöntemi olarak ayarlanmış trueyöntemini raiseOnDataBinding çağırırControl.DataBind(Boolean).

Not

yönteminin Control.DataBind(Boolean) set ile raiseOnDataBinding çağrılması false , alt denetimlerin yöntemine Control.DataBind() bağlı verilere neden olur.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1