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 propiedad UpdateMethod y utilizando los parámetros suministrados en las colecciones keys, values o 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
Colección IDictionary de claves principales utilizadas con la propiedad UpdateMethod para realizar la operación de actualización de base de datos. Si no hay claves asociadas al método, se debe pasar null.
- values
- IDictionary
Colección IDictionary de valores que se deben utilizar con la propiedad UpdateMethod para realizar la operación de actualización de base de datos. Si no hay parámetros asociados al método, se debe pasar null.
- oldValues
- IDictionary
IDictionary que representa los valores originales del almacén de datos subyacente. Si no hay parámetros asociados a la consulta, se debe pasar null.
Devoluciones
Número de filas actualizadas o -1, si no se conoce el número. Para obtener más información, vea Update().
Excepciones
La propiedad CanInsert devuelve false.
El valor de oldValues es null o está vacío y la propiedad 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 directamente al ExecuteUpdate método; en su lugar, use 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 el formato de 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 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, los 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, 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 actualizadas, vea Update.
