Partager via


ObjectDataSourceView.ExecuteInsert(IDictionary) Méthode

Définition

Exécute une opération d'insertion en appelant la méthode de l'objet métier qui est identifiée par la propriété InsertMethod à l'aide de la collection values spécifiée.

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Paramètres

values
IDictionary

IDictionary de paramètres utilisé avec la propriété InsertMethod pour exécuter l'opération d'insertion. Si aucun paramètre n'est associé à la méthode, passez la valeur null.

Retours

Nombre de lignes insérées ; sinon, -1 si le nombre n'est pas connu. Pour plus d'informations, consultez Insert.

Exceptions

La propriété CanInsert retourne la valeur false.

values a la valeur null ou est vide.

Remarques

La ObjectDataSourceView classe implémente la méthode héritée ExecuteInsert pour insérer des données dans un magasin de données sous-jacent à l’aide d’un objet métier. Les développeurs de pages et les auteurs de contrôles liés aux données n’appellent pas directement la ExecuteInsert méthode ; à la place, utilisez la méthode exposée Insert publiquement.

Avant l’insertion, la OnInserting méthode est appelée pour déclencher l’événement Inserting . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer un prétraitement avant l’appel de la Insert méthode.

Pour effectuer une opération d’insertion, le contrôle utilise la ObjectDataSourceView réflexion pour appeler la méthode identifiée par la InsertMethod propriété et tous les paramètres associés qui se trouvent dans la values collection, puis l’exécuter. Une fois l’opération terminée, la OnInserted méthode est appelée pour déclencher l’événement Inserted . Vous pouvez gérer cet événement pour examiner les valeurs de retour, les codes d’erreur et effectuer un post-traitement.

Pour plus d’informations sur le retour du nombre de lignes insérées, consultez Insert.

S’applique à

Voir aussi