Compartir a través de


ObjectDataSourceView.ExecuteInsert(IDictionary) Método

Definición

Realiza una operación de inserción mediante una llamada al método de objetos comerciales identificado por la propiedad InsertMethod y utilizando la colección values especificada.

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

Parámetros

values
IDictionary

Colección IDictionary de parámetros utilizados con la propiedad InsertMethod para realizar la operación de inserción. Si no hay parámetros asociados al método, se debe pasar null.

Devoluciones

Número de filas insertadas; en caso contrario, -1, si no se conoce el número. Para obtener más información, vea Insert.

Excepciones

La propiedad CanInsert devuelve false.

El valor de values es null o está vacío.

Comentarios

La ObjectDataSourceView clase implementa el método heredado ExecuteInsert para insertar datos en un almacén de datos subyacente mediante un objeto de negocio. Los desarrolladores de páginas y los autores de controles enlazados a datos no llaman al ExecuteInsert método directamente; en su lugar, usan el método expuesto Insert públicamente.

Antes de realizar la inserción, OnInserting se llama al método para generar el Inserting evento. Puede controlar este evento para examinar los valores de los parámetros y realizar cualquier preprocesamiento antes de llamar al Insert método .

Para realizar una operación de inserción, el ObjectDataSourceView control usa la reflexión para llamar al método identificado por la InsertMethod propiedad y los parámetros asociados que se encuentran en la values colección y, a continuación, los ejecuta. Una vez completada la operación, OnInserted se llama al método para generar el Inserted evento. Puede controlar este evento para examinar los valores devueltos, los códigos de error y realizar cualquier procesamiento posterior.

Para obtener más información sobre cómo devolver el número de filas insertadas, vea Insert.

Se aplica a

Consulte también