SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, 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 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 -> 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 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
Valor que representa el número de filas actualizadas en la base de datos subyacente.
Excepciones
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.
El usuario actual no tiene los permisos necesarios para obtener acceso a la base de datos.
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.
