ListView.OnItemInserting(ListViewInsertEventArgs) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.Extensions.dll

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.

ItemInserting Zgłasza zdarzenie.

protected:
 virtual void OnItemInserting(System::Web::UI::WebControls::ListViewInsertEventArgs ^ e);

protected virtual void OnItemInserting (System.Web.UI.WebControls.ListViewInsertEventArgs e);

abstract member OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit
override this.OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit

Protected Overridable Sub OnItemInserting (e As ListViewInsertEventArgs)

Parametry

e: ListViewInsertEventArgs

Dane dotyczące zdarzenia.

Wyjątki

InvalidOperationException

Kontrolka ListView nie jest powiązana z kontrolką źródła danych przy użyciu DataSourceID właściwości .

Uwagi

Kontrolka ListView zgłasza ItemInserting zdarzenie po kliknięciu przycisku Wstaw w kontrolce lub InsertNewItem wywołaniu metody, ale zanim ListView kontrolka wstawi rekord. (Przycisk Wstaw to kontrolka przycisku, której CommandName właściwość jest ustawiona na "Wstaw". Dzięki temu można wykonać niestandardową procedurę za każdym razem, gdy wystąpi to zdarzenie, takie jak kodowanie HTML lub weryfikowanie wartości rekordu przed wstawieniem w źródle danych.

Metoda jest wywoływana OnItemInserting przez kontrolkę ListView ItemInserting w celu podniesienia zdarzenia. Jest on zwykle używany przez deweloperów sterujących podczas rozszerzania ListView klasy.

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

Metoda OnItemInserting 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

Po przesłonięciu OnItemInserting(ListViewInsertEventArgs) w klasie pochodnej wywołaj metodę klasy OnItemInserting(ListViewInsertEventArgs) bazowej, aby zarejestrowani delegaci otrzymywali zdarzenie.

Dotyczy