Share via

ObjectDataSourceView.ExecuteUpdate Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

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 -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Pará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

Int32

Número de filas actualizadas o -1, si no se conoce el número. Para obtener más información, vea Update().

Excepciones

NotSupportedException

La propiedad CanInsert devuelve false.

InvalidOperationException

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.

Se aplica a

Consulte también