ObjectDataSourceView.ExecuteUpdate 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 actualización llamando al método identificado por la UpdateMethod propiedad y utilizando los parámetros proporcionados en las keyscolecciones , valueso oldValues .
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParámetros
- keys
- IDictionary
de IDictionary claves principales que se van a usar con la UpdateMethod propiedad para realizar la operación de actualización de la base de datos. Si no hay claves asociadas al método , pase null.
- values
- IDictionary
IDictionary de valores que se van a usar con UpdateMethod para realizar la operación de actualización de la base de datos. Si no hay ningún parámetro asociado al método , pase null.
- oldValues
- IDictionary
IDictionary que representa los valores originales en el almacén de datos subyacente. Si no hay ningún parámetro asociado a la consulta, pase null.
Devoluciones
Número de filas actualizadas; o -1, si no se conoce el número. Para obtener más información, consulte Update().
Excepciones
La CanInsert propiedad devuelve false.
oldValues es o está null vacío y ConflictDetection se establece en CompareAllValues.
Comentarios
La ObjectDataSourceView clase implementa el método heredado ExecuteUpdate para actualizar los datos mediante un objeto de negocio. Los desarrolladores de páginas y los autores de controles enlazados a datos no llaman al ExecuteUpdate método directamente; en su lugar, usan el método expuesto Update públicamente.
Los valores contenidos en las keys colecciones y values se evalúan y combinan con los valores contenidos en la UpdateParameters colección. Si la ConflictDetection propiedad se establece en el CompareAllValues valor, los valores contenidos en la oldValues colección tienen formato con la OldValuesParameterFormatString propiedad y también se combinan.
Antes de realizar la operación de actualización, OnUpdating se llama al método para generar el Updating evento. Puede controlar este evento para examinar los valores de los parámetros y para realizar cualquier preprocesamiento antes de una actualización. Para realizar una operación de actualización, usa la ObjectDataSourceView reflexión para llamar al método identificado por la UpdateMethod propiedad y los parámetros asociados de la keys colección y, a continuación, lo ejecuta. Una vez completada la operación, OnUpdated se llama al método para generar el Updated evento. Puede controlar este evento para examinar los valores devueltos, códigos de error y realizar cualquier procesamiento posterior.
Para obtener más información sobre cómo devolver el número de filas actualizadas, vea Update.
