DataSourceView.ExecuteDelete(IDictionary, IDictionary) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Realiza uma operação de eliminação da lista de dados que o DataSourceView objeto 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 objetos ou chaves de linha a serem eliminadas pela ExecuteDelete(IDictionary, IDictionary) operação.
- oldValues
- IDictionary
E IDictionary de pares nome/valor que representam elementos de dados e os seus valores originais.
Devoluções
O número de itens que foram eliminados do armazenamento de dados subjacente.
Exceções
A ExecuteDelete(IDictionary, IDictionary) operação não é suportada pelo DataSourceView.
Exemplos
O exemplo de código seguinte demonstra como uma classe que estende a DataSourceView classe pode sobrepor 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
Observações
Os controlos de dados limitados podem determinar se a ExecuteDelete operação é suportada por um controlo de fonte de dados, recuperando o DataSourceView objeto através do DataSourceControl.GetView método e verificando a CanDelete propriedade.
O keys parâmetro representa o objeto ou as chaves de linha dos dados a eliminar. Para fontes de dados que representam dados relacionais, como o SqlDataSource controlo, o keys parâmetro é uma coleção de chaves primárias da base de dados. Noutros cenários, o keys parâmetro é uma coleção de pares nome/valor e é usado para filtrar uma lista de dados. Qualquer dado que corresponda a um par nome/valor é eliminado.
Note
A DataSourceView implementação padrão da classe é lançar uma NotSupportedException exceção. Se estenderes a DataSourceView classe, substitui o ExecuteDelete método se a tua classe suportar a eliminação do armazenamento de dados subjacente.