SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Método

  • Referencia

Definición

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

Realiza una operación de actualización utilizando la cadena SQL UpdateCommand, los parámetros de la colección UpdateParameters y los valores de las colecciones keys, values y oldValues especificadas.

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 UpdateCommand para realizar la operación de actualización de base de datos. Si no hay claves asociadas a la consulta o la propiedad UpdateCommand no es una consulta SQL con parámetros, pase null.

values
IDictionary

Colección IDictionary de valores utilizados con la propiedad UpdateCommand para realizar la operación de actualización de base de datos. Si no hay parámetros asociados a la consulta o la propiedad UpdateCommand no es una consulta SQL con parámetros, pase null.

oldValues
IDictionary

IDictionary que representa los valores originales de la base de datos. Si no hay parámetros asociados a la consulta o la propiedad UpdateCommand no es una consulta SQL con parámetros, pase null.

Devoluciones

Int32

Valor que representa el número de filas actualizadas en la base de datos subyacente.

Excepciones

InvalidOperationException

El control SqlDataSource no puede establecer una conexión con el origen de datos subyacente.

o bien

La propiedad ConflictDetection está establecida en el valor CompareAllValues y no se pasan parámetros oldValues.

HttpException

El usuario actual no tiene los permisos necesarios para obtener acceso a la base de datos.

NotSupportedException

La propiedad CanUpdate es false.

Comentarios

La SqlDataSourceView clase implementa el método heredado ExecuteUpdate para actualizar los datos de una base de datos. 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 CompareAllValuesen , los valores contenidos en la oldValues colección tienen el formato OldValuesParameterFormatString 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 la operación, compila SqlDataSourceView un DbCommand objeto mediante el UpdateCommand texto y las propiedades asociadas UpdateParameters y, a continuación, ejecuta el DbCommand objeto en la base de datos subyacente. 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 y los códigos de error y realizar cualquier procesamiento posterior.

Se aplica a

Consulte también