SqlDataSourceView.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 à 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParamè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.
