Exporter (0) Imprimer
Développer tout

ObjectDataSourceView.ExecuteInsert, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Exécute une opération d'insertion en appelant la méthode de l'objet métier qui est identifiée par la propriété InsertMethod à l'aide de la collection values spécifiée.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

protected override int ExecuteInsert (
	IDictionary values
)
protected int ExecuteInsert (
	IDictionary values
)
protected override function ExecuteInsert (
	values : IDictionary
) : int

Paramètres

values

IDictionary de paramètres utilisé avec la propriété InsertMethod pour exécuter l'opération d'insertion. Si aucun paramètre n'est associé à la méthode, passez la valeur référence Null (Nothing en Visual Basic).

Valeur de retour

Nombre de lignes insérées ; sinon, -1 si le nombre n'est pas connu. Pour plus d'informations, consultez Insert.

Type d'exceptionCondition

NotSupportedException

La propriété CanInsert retourne la valeur false.

La classe ObjectDataSourceView implémente la méthode ExecuteInsert héritée pour insérer les 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 méthode ExecuteInsert ; ils utilisent la méthode Insert publiquement exposée.

Avant que l'insertion ne soit effectuée, la méthode OnInserting 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 que la méthode Insert ne soit appelée.

Pour effectuer une opération d'insertion, le contrôle ObjectDataSourceView utilise d'abord la réflexion pour appeler la méthode qui est identifiée par la propriété InsertMethod et par les paramètres associés qui sont dans la collection values. Lorsque l'opération est terminée, la méthode OnInserted est appelée pour déclencher l'événement Inserted. Vous pouvez gérer cet événement pour examiner toutes les valeurs de retour et tous les codes d'erreur, ainsi que pour effectuer tout post-traitement.

Pour plus d'informations sur le retour du nombre de lignes insérées, consultez Insert.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft