SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

  • Referencia

Definición

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

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

Int32

Valor que representa el número de filas eliminadas de 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 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.

NotSupportedException

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.

Se aplica a

Consulte también