TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Yöntem

Tanım

Denetimin TreeNodePopulateTreeView olayını tetikler.

protected:
 virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);
protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);
abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

Parametreler

e
TreeNodeEventArgs

TreeNodeEventArgs Olay verilerini içeren bir.

Açıklamalar

Bazen, veri boyutu veya kullanıcı girişine bağlı özel içerik nedeniyle ağaç yapısını statik olarak önceden tanımlı yapmak pratik değildir. Bu nedenle denetim dinamik TreeView düğüm popülasyonunu destekler. Bir düğümün PopulateOnDemand özelliği olarak trueayarlandığında, düğüm genişletildiğinde bu düğüm çalışma zamanında doldurulur.

Bir düğümü dinamik olarak doldurmak için önce düğümün PopulateOnDemand özelliğini olarak trueayarlayın. Ardından, düğümü program aracılığıyla dolduran olay için TreeNodePopulate bir olay işleme yöntemi tanımlayın. Tipik bir olay işleme yöntemi bir veri kaynağından düğüm verilerini alır, verileri bir düğüm yapısına yerleştirir ve ardından düğüm yapısını doldurulan düğümün koleksiyonuna ChildNodes ekler. Bir üst düğüm koleksiyonuna ChildNodes nesneler eklenerek TreeNode bir düğüm yapısı oluşturulur.

Not

Bir düğümün PopulateOnDemand özelliği olarak trueayarlandığında, düğüm dinamik olarak doldurulmalıdır. Altta başka bir düğümü bildirimli olarak iç içe yerleştiremezsiniz; aksi takdirde, sayfada bir hata oluşur.

Desteklenen tarayıcılar (Microsoft Internet Explorer 4.0 uyumlu tarayıcılar ve üzeri) istemci tarafı düğüm popülasyonu avantajından da yararlanabilir. Etkinleştirildiğinde, bu düğüm genişletildiğinde denetimin TreeView istemcideki bir düğümü dinamik olarak doldurmasına olanak tanır ve bu da sunucuya geri gönderme gereksinimini önler. İstemci tarafı düğüm popülasyonu hakkında daha fazla bilgi için bkz PopulateNodesFromClient. .

Olay bildirmek, bir temsilci yoluyla olay işleyicisini çağırır. Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

yöntemi, OnTreeNodePopulate türetilmiş sınıfların bir temsilci eklemeden olayı işlemesine de izin verir. Bu, türetilmiş bir sınıftaki olayı işlemek için tercih edilen tekniktir.

Devralanlara Notlar

Türetilmiş bir sınıfta yöntemini geçersiz kıldığınızda OnTreeNodePopulate(TreeNodeEventArgs) , kayıtlı temsilcilerin OnTreeNodePopulate(TreeNodeEventArgs) olayı alması için temel sınıf için yöntemini çağırdığınızdan emin olun.

Şunlara uygulanır

Ayrıca bkz.