ObjectDataSourceView.ExecuteInsert(IDictionary) Méthode
Définition
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.
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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParamè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.
