Partager via


SqlDataSourceView.ExecuteInsert(IDictionary) Méthode

Définition

Exécute une opération d'insertion à l'aide de la chaîne InsertCommand SQL, de tout paramètre spécifié dans la collection InsertParameters et des valeurs qui se trouvent dans 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 valeurs utilisé avec la propriété InsertCommand pour exécuter l'opération d'insertion de base de données. S'il n'y a pas de paramètre associé à la requête ou si la propriété InsertCommand n'est pas une requête SQL paramétrée, passez null.

Retours

Une valeur qui représente le nombre de lignes insérées dans la base de données sous-jacente.

Exceptions

SqlDataSource ne peut pas établir de connexion avec la source de données sous-jacente.

L'utilisateur actuel n'a pas les autorisations appropriées pour accéder à la base de données.

La propriété CanInsert a la valeur false.

Remarques

La SqlDataSourceView classe implémente la méthode héritée ExecuteInsert pour insérer des données dans une base de données. 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’opération d’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 une insertion.

Pour effectuer une opération d’insertion, l’objet SqlDataSourceView génère un DbCommand objet à l’aide du InsertCommand texte et des propriétés associées InsertParameters , puis exécute l’objet DbCommand sur la base de données sous-jacente. Une fois l’insertion 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 et les codes d’erreur et effectuer un post-traitement.

S’applique à

Voir aussi