SqlDataSourceView.ExecuteDelete(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 eliminación utilizando la cadena SQL DeleteCommand, los parámetros especificados en la colección DeleteParameters y los valores de las colecciones keys
y oldValues
especificadas.
protected:
override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer
Parámetros
- keys
- IDictionary
Colección IDictionary de valores de objeto o de clave para que los elimine la operación ExecuteDelete(IDictionary, IDictionary).
- oldValues
- IDictionary
IDictionary con valores de fila que se evalúan sólo la propiedad ConflictDetection está establecida en el valor CompareAllValues.
Devoluciones
Valor que representa el número de filas eliminadas de 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 de acceso a la base de datos.
o bien
La instancia del control es un control AccessDataSource y se deniega el acceso a la ruta de acceso que especifica la propiedad DataFile.
La propiedad CanDelete es false
.
o bien
El diseñador no asignó correctamente una ruta de acceso relativa en tiempo de diseño antes de utilizar una instancia del control AccessDataSource.
Comentarios
La SqlDataSourceView clase implementa el método heredado ExecuteDelete para eliminar datos de una base de datos. Los desarrolladores de páginas y los autores de controles enlazados a datos no llaman al ExecuteDelete método directamente; en su lugar, usan el método expuesto Delete públicamente.
Los valores contenidos en la keys
colección se evalúan y combinan con los valores contenidos en la DeleteParameters 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 eliminación, OnDeleting se llama al método para generar el Deleting evento. Puede controlar este evento para examinar los valores de los parámetros y realizar cualquier preprocesamiento antes de una eliminación.
Para realizar una operación de eliminación, el SqlDataSourceView objeto crea un DbCommand objeto mediante el DeleteCommand texto y las propiedades asociadas DeleteParameters y, a continuación, ejecuta el DbCommand objeto en la base de datos subyacente. Una vez completada la operación de eliminación, OnDeleted se llama al método para generar el Deleted evento. Puede controlar este evento para examinar los valores devueltos y los códigos de error y realizar cualquier procesamiento posterior.