Udostępnij za pośrednictwem


TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metoda

Definicja

TreeNodePopulate Zgłasza zdarzenie kontrolkiTreeView.

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)

Parametry

e
TreeNodeEventArgs

Element TreeNodeEventArgs zawierający dane zdarzenia.

Uwagi

Czasami nie jest praktyczne, aby statycznie wstępnie zdefiniować strukturę drzewa ze względu na rozmiar danych lub niestandardową zawartość, która zależy od danych wejściowych użytkownika. W związku z tym kontrolka obsługuje populację TreeView węzłów dynamicznych. Gdy PopulateOnDemand właściwość węzła jest ustawiona na true, ten węzeł zostanie wypełniony w czasie wykonywania po rozwinięciu węzła.

Aby dynamicznie wypełnić węzeł, najpierw ustaw PopulateOnDemand właściwość węzła na true. Następnie zdefiniuj metodę obsługi zdarzeń dla TreeNodePopulate zdarzenia, które programowo wypełnia węzeł. Typowa metoda obsługi zdarzeń pobiera dane węzła ze źródła danych, umieszcza dane w strukturze węzła, a następnie dodaje strukturę węzłów do ChildNodes kolekcji wypełnionego węzła. Struktura węzłów jest tworzona przez dodanie TreeNode obiektów do ChildNodes kolekcji węzła nadrzędnego.

Uwaga

Gdy PopulateOnDemand właściwość węzła jest ustawiona na true, węzeł musi być wypełniany dynamicznie. Nie można deklaratywnie zagnieżdżać innego węzła poniżej niego; w przeciwnym razie na stronie wystąpi błąd.

Obsługiwane przeglądarki (przeglądarki zgodne z programem Microsoft Internet Explorer 4.0 i nowsze) mogą również korzystać z populacji węzłów po stronie klienta. Po włączeniu tej opcji umożliwia TreeView to kontrolce dynamiczne wypełnianie węzła na kliencie po rozwinięciu tego węzła, co uniemożliwia powrót do serwera. Aby uzyskać więcej informacji na temat populacji węzłów po stronie klienta, zobacz PopulateNodesFromClient.

Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Metoda OnTreeNodePopulate umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.

Uwagi dotyczące dziedziczenia

Podczas zastępowania OnTreeNodePopulate(TreeNodeEventArgs) metody w klasie pochodnej należy wywołać OnTreeNodePopulate(TreeNodeEventArgs) metodę dla klasy bazowej, aby zarejestrowani delegaci otrzymywali zdarzenie.

Dotyczy

Zobacz też