ListView.OnItemInserting(ListViewInsertEventArgs) Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Déclenche l’événement ItemInserting.

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)

Paramètres

e: ListViewInsertEventArgs

Données d'événement.

Exceptions

InvalidOperationException

Le contrôle ListView n'est pas lié à un contrôle de source de données à l'aide de la propriété DataSourceID.

Remarques

Le ListView contrôle déclenche l’événement ItemInserting lorsqu’un bouton Insérer dans le contrôle est cliqué ou que la InsertNewItem méthode est appelée, mais avant que le ListView contrôle insère l’enregistrement. (Un bouton Insérer est un contrôle de bouton dont CommandName la propriété est définie sur « Insérer ».) Cela vous permet d’effectuer une routine personnalisée chaque fois que cet événement se produit, comme l’encodage HTML ou la validation des valeurs d’un enregistrement avant son insertion dans la source de données.

La OnItemInserting méthode est appelée par le ListView contrôle pour déclencher l’événement ItemInserting . Il est généralement utilisé par les développeurs de contrôle lors de l’extension de la ListView classe.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations, consultez gestion et déclenchement d’événements.

La OnItemInserting méthode permet également aux classes dérivées de gérer l’événement sans attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

Lorsque vous remplacez OnItemInserting(ListViewInsertEventArgs) dans une classe dérivée, appelez la méthode de la classe de OnItemInserting(ListViewInsertEventArgs) base afin que les délégués inscrits reçoivent l’événement.

S’applique à