DataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Executa uma operação de exclusão na lista de dados que o 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

Um IDictionary de chaves de linha ou objeto a ser excluído pela operação ExecuteDelete(IDictionary, IDictionary).

oldValues
IDictionary

Um IDictionary de pares nome-valor que representa os elementos de dados e seus valores originais.

Retornos

Int32

O número de itens que foram excluídos do armazenamento de dados subjacente.

Exceções

NotSupportedException

Não há suporte para a operação ExecuteDelete(IDictionary, IDictionary) pelo DataSourceView.

Exemplos

O exemplo de código a seguir demonstra como uma classe que estende a DataSourceView classe pode substituir a CanDelete propriedade e o ExecuteDelete método. Este exemplo de código faz parte de um exemplo maior fornecido para a DataSourceView classe.

// 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

Comentários

Os controles associados a dados podem determinar se a ExecuteDelete operação tem suporte por um controle de fonte de dados recuperando o DataSourceView objeto usando o DataSourceControl.GetView método e verificando a CanDelete propriedade.

O keys parâmetro representa as chaves de objeto ou linha dos dados a serem excluídos. Para fontes de dados que representam dados relacionais, como o SqlDataSource controle, o keys parâmetro é uma coleção de chaves primárias do banco de dados. Em outros cenários, o keys parâmetro é uma coleção de pares nome/valor e é usado para filtrar uma lista de dados. Todos os dados correspondentes a um par nome/valor são excluídos.

Observação

A DataSourceView implementação padrão da classe é gerar uma NotSupportedException exceção. Se você estender a DataSourceView classe, substitua o ExecuteDelete método se sua classe der suporte à exclusão do armazenamento de dados subjacente.

Aplica-se a

Confira também