SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

Definición

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.Performs a delete operation using the DeleteCommand SQL string, any parameters that are specified in the DeleteParameters collection, and the values that are in the specified keys and oldValues collections.

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).An IDictionary of object or row key values for the ExecuteDelete(IDictionary, IDictionary) operation to delete.

oldValues
IDictionary

IDictionary con valores de fila que se evalúan sólo la propiedad ConflictDetection está establecida en el valor CompareAllValues.An IDictionary that contains row values that are evaluated only if the ConflictDetection property is set to the CompareAllValues value.

Devoluciones

Int32

Valor que representa el número de filas eliminadas de la base de datos subyacente.A value that represents the number of rows deleted from the underlying database.

Excepciones

El control SqlDataSource no puede establecer una conexión con el origen de datos subyacente.The SqlDataSource cannot establish a connection with the underlying data source.

o bien-or- La propiedad ConflictDetection está establecida en el valor CompareAllValues y no se pasan parámetros oldValues.The ConflictDetection property is set to the CompareAllValues value and no oldValues parameters are passed.

El usuario actual no tiene los permisos necesarios de acceso a la base de datos.The current user does not have the correct permissions to access to the database.

o bien-or- La instancia del control es un control AccessDataSource y se deniega el acceso a la ruta de acceso que especifica la propiedad DataFile.The instance of the control is an AccessDataSource control and access is denied to the path specified for the DataFile property.

La propiedad CanDelete es false.The CanDelete property is false.

o bien-or- El diseñador no asignó correctamente una ruta de acceso relativa en tiempo de diseño antes de utilizar una instancia del control AccessDataSource.A design-time relative path was not mapped correctly by the designer before using an instance of the AccessDataSource control.

Comentarios

La SqlDataSourceView clase implementa el método heredado ExecuteDelete para eliminar datos de una base de datos.The SqlDataSourceView class implements the inherited ExecuteDelete method to delete data from a database. 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 públicamente Delete .Page developers and data-bound control authors do not call the ExecuteDelete method directly; instead, use the publicly exposed Delete method.

Los valores contenidos en la keys colección se evalúan y se combinan con los valores contenidos en la DeleteParameters colección.The values that are contained in the keys collection are evaluated and merged with any values that are contained by the DeleteParameters collection. Si la ConflictDetection propiedad se establece en el CompareAllValues valor, se da formato a los valores contenidos en la oldValues colección con la OldValuesParameterFormatString propiedad y también se combinan.If the ConflictDetection property is set to the CompareAllValues value, the values that are contained in the oldValues collection are formatted with the OldValuesParameterFormatString property and are also merged.

Antes de que se realice la operación de eliminación, OnDeleting se llama al método para generar el Deleting evento.Before the delete operation is performed, the OnDeleting method is called to raise the Deleting event. Puede controlar este evento para examinar los valores de los parámetros y realizar cualquier preprocesamiento antes de una eliminación.You can handle this event to examine the values of the parameters and to perform any preprocessing before a delete.

Para realizar una operación de eliminación, el SqlDataSourceView objeto genera un DbCommand objeto utilizando el DeleteCommand texto y las propiedades asociadas y DeleteParameters , a continuación, ejecuta el DbCommand objeto en la base de datos subyacente.To perform a delete operation, the SqlDataSourceView object builds a DbCommand object using the DeleteCommand text and any associated DeleteParameters properties, and then executes the DbCommand object against the underlying database. Una vez finalizada la operación de eliminación, OnDeleted se llama al método para generar el Deleted evento.After the delete operation completes, the OnDeleted method is called to raise the Deleted event. Puede controlar este evento para examinar los valores devueltos y los códigos de error, así como para realizar cualquier procesamiento posterior.You can handle this event to examine any return values and error codes and to perform any post-processing.

Se aplica a

Consulte también