DataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

Definición

Realiza una operación de eliminación en la lista de datos que el objeto DataSourceView representa.

protected:
 virtual int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
abstract member ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parámetros

keys
IDictionary

Interfaz IDictionary de claves de objetos o filas que se va a eliminar mediante la operación de ExecuteDelete(IDictionary, IDictionary).

oldValues
IDictionary

Interfaz IDictionary de pares de nombre/valor que representan los elementos de datos y sus valores originales.

Devoluciones

Número de elementos que se eliminaron del espacio de almacenamiento de datos subyacente.

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase que extiende la DataSourceView clase puede invalidar la CanDelete propiedad y el ExecuteDelete método . Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase DataSourceView.

// The CsvDataSourceView does not currently
// permit deletion. You can modify or extend
// this sample to do so.
public override bool CanDelete {
    get {
        return false;
    }
}
protected override int ExecuteDelete(IDictionary keys, IDictionary values)
{
    throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit deletion. You can modify or extend
' this sample to do so.
Public Overrides ReadOnly Property CanDelete() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteDelete

Comentarios

Los controles enlazados a datos pueden determinar si una ExecuteDelete operación es compatible con un control de origen de datos recuperando el DataSourceView objeto mediante el DataSourceControl.GetView método y comprobando la CanDelete propiedad .

El keys parámetro representa las claves de objeto o fila de los datos que se van a eliminar. Para los orígenes de datos que representan datos relacionales, como el SqlDataSource control , el keys parámetro es una colección de claves principales de base de datos. En otros escenarios, el keys parámetro es una colección de pares nombre-valor y se usa para filtrar una lista de datos. Se elimina cualquier dato que coincida con un par nombre-valor.

Nota

La implementación predeterminada de la DataSourceView clase es iniciar una NotSupportedException excepción. Si extiende la DataSourceView clase , invalide el ExecuteDelete método si la clase admite la eliminación del almacenamiento de datos subyacente.

Se aplica a

Consulte también