ListView.OnItemInserting(ListViewInsertEventArgs) Metoda

Definicja

Podnosi ItemInserting zdarzenie.Raises the ItemInserting event.

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.The event data.

Wyjątki

ListViewFormant nie jest powiązany z kontrolką źródła danych przy użyciu DataSourceID właściwości.The ListView control is not bound to a data source control by using the DataSourceID property.

Uwagi

ListViewKontrolka wywołuje ItemInserting zdarzenie po kliknięciu przycisku wstawiania w kontrolce lub InsertNewItem wywołaniu metody, ale przed ListView wstawieniem rekordu przez formant.The ListView control raises the ItemInserting event when an Insert button in the control is clicked or the InsertNewItem method is called, but before the ListView control inserts the record. (Przycisk Wstaw jest formantem przycisku, którego CommandName Właściwość jest ustawiona na "INSERT"). Dzięki temu można wykonać niestandardową procedurę w przypadku wystąpienia tego zdarzenia, takiego jak kodowanie HTML lub Walidacja wartości rekordu przed jego wstawieniem do źródła danych.(An Insert button is a button control whose CommandName property is set to "Insert".) This enables you to perform a custom routine whenever this event occurs, such as HTML-encoding or validating the values of a record before it is inserted in the data source.

OnItemInsertingMetoda jest wywoływana przez formant w ListView celu podniesienia ItemInserting zdarzenia.The OnItemInserting method is called by the ListView control to raise the ItemInserting event. Jest on zwykle używany przez deweloperów kontroli podczas rozszerzania ListView klasy.It is typically used by control developers when extending the ListView class.

Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata.Raising an event invokes the event handler through a delegate. Aby uzyskać więcej informacji, zobacz Obsługa iwywoływanie zdarzeń.For more information, see Handling and Raising Events.

OnItemInsertingMetoda włącza również klasy pochodne do obsługi zdarzenia bez dołączania delegata.The OnItemInserting method also enables derived classes to handle the event without attaching a delegate. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.This is the preferred technique for handling the event in a derived class.

Uwagi dotyczące dziedziczenia

Podczas przesłonięcia OnItemInserting(ListViewInsertEventArgs) w klasie pochodnej należy wywołać metodę klasy bazowej, OnItemInserting(ListViewInsertEventArgs) tak aby zarejestrowane Delegaty otrzymywały zdarzenie.When you override OnItemInserting(ListViewInsertEventArgs) in a derived class, call the base class's OnItemInserting(ListViewInsertEventArgs) method so that registered delegates receive the event.

Dotyczy

Zobacz też