ObjectDataSourceView.ExecuteInsert(IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerPará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.
