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.
Effectue une opération d’insertion en appelant la méthode d’objet métier identifiée par la propriété à l’aide de la InsertMethod collection spécifiée values .
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
Paramètres IDictionary utilisés avec la InsertMethod propriété pour effectuer l’opération d’insertion. S’il n’existe aucun paramètre associé à la méthode, passez 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 CanInsert propriété retourne false.
values est null ou 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 ; utilisez plutôt la méthode exposée Insert publiquement.
Avant l’exécution de 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 tout prétraitement avant l’appel de la Insert méthode.
Pour effectuer une opération d’insertion, le ObjectDataSourceView contrôle utilise la 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écute. 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 tout post-traitement.
Pour plus d’informations sur le renvoi du nombre de lignes insérées, consultez Insert.
