ObjectDataSource.Insert ObjectDataSource.Insert ObjectDataSource.Insert ObjectDataSource.Insert Method

Définition

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.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

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.A value that represents the number of rows inserted into the underlying data storage.

Remarques

Avant l' Insert exécution de l’opération, OnInserting la méthode est appelée pour déclencher Inserting l’événement.Before the Insert operation is performed, the OnInserting method is called to raise the Inserting event. Vous pouvez gérer l' Inserting événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une Insert opération.You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. Pour effectuer une opération d’insertion, ObjectDataSourceView l’objet utilise la réflexion pour créer une instance de l’objet identifié par la TypeName propriété.To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Il appelle ensuite la méthode identifiée par la InsertMethod propriété, à l’aide de toutes les propriétés associées. InsertParametersIt then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. Une fois Insert l’opération terminée, la OnInserted méthode est appelée pour déclencher l' Inserted événement.After the Insert operation completes, the OnInserted method is called to raise the Inserted event. Vous pouvez gérer l' Inserted événement pour examiner les valeurs de retour, les paramètres de sortie et les exceptions, et pour effectuer tout le traitement.You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

La Insert méthode délègue à Insert la méthode du ObjectDataSourceView associé ObjectDataSource au contrôle.The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Pour plus d’informations sur la fusion des paramètres, la durée de vie des InsertMethodobjets et la résolution des méthodes, consultez.For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

Contrôles liés aux donnéesData-Bound Controls

Lorsque l' ObjectDataSource objet est associé à un contrôle lié aux données, tel que le GridView contrôle, il n’est pas nécessaire d’appeler Insert la méthode à partir du code de la page.When the ObjectDataSource object is associated with a data-bound control, such as the GridView control, it is not necessary to call the Insert method from page code. La Insert méthode est appelée directement par le contrôle lié aux données à la place.The Insert method is invoked directly by the data-bound control instead.

S’applique à

Voir aussi