TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)Parametry
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.
