ObjectDataSource.Insert 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 qui est identifiée par la propriété InsertMethod et tous les paramètres dans la collection InsertParameters.
public:
int Insert();
public int Insert ();
member this.Insert : unit -> int
Public Function Insert () As Integer
Retours
Valeur qui représente le nombre de lignes insérées dans le stockage de données sous-jacent.
Remarques
Avant l’exécution de l’opération Insert , la OnInserting méthode est appelée pour déclencher l’événement Inserting . Vous pouvez gérer l’événement Inserting pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une Insert opération. Pour effectuer une opération d’insertion, l’objet utilise la ObjectDataSourceView réflexion pour créer une instance de l’objet identifié par la TypeName propriété . Il appelle ensuite la méthode identifiée par la propriété, à l’aide InsertMethod de toutes les propriétés associées InsertParameters . Une fois l’opération Insert terminée, la OnInserted méthode est appelée pour déclencher l’événement Inserted . Vous pouvez gérer l’événement Inserted pour examiner les valeurs de retour, les paramètres de sortie et les exceptions, et pour effectuer tout post-traitement.
La Insert méthode délègue à la Insert méthode du ObjectDataSourceView associé au ObjectDataSource contrôle .
Pour plus d’informations sur la fusion de paramètres, la durée de vie des objets et la résolution de méthode, consultez InsertMethod.
Contrôles liés aux données
Lorsque l’objet ObjectDataSource est associé à un contrôle lié aux données, tel que le GridView contrôle, il n’est pas nécessaire d’appeler la Insert méthode à partir du code de page. La Insert méthode est appelée directement par le contrôle lié aux données à la place.