SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

  • Referência

Definição

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

Executa uma operação de exclusão usando a cadeia de caracteres SQL DeleteCommand, quaisquer parâmetros que estão especificados na coleção DeleteParameters e os valores que estão nas coleções keys e 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

Um IDictionary dos valores de chave de linha ou objeto para a operação ExecuteDelete(IDictionary, IDictionary) a ser excluída.

oldValues
IDictionary

Um IDictionary que contém os valores de linha avaliados apenas se a propriedade ConflictDetection estiver definida para o valor CompareAllValues.

Retornos

Int32

Um valor que representa o número de linhas excluídas no banco de dados subjacente.

Exceções

InvalidOperationException

O SqlDataSource não pode estabelecer uma conexão com a fonte de dados subjacente.

- ou -

A propriedade ConflictDetection é definida como o valor CompareAllValues e nenhum parâmetro oldValues é passado.

HttpException

O usuário atual não tem as permissões corretas para acessar o banco de dados.

- ou -

A instância do controle é um controle AccessDataSource e o acesso é negado ao caminho especificado para a propriedade DataFile.

NotSupportedException

A propriedade CanDelete é false.

- ou -

Um caminho relativo em tempo de design não foi mapeado corretamente pelo designer antes do uso de uma instância do controle AccessDataSource.

Comentários

A SqlDataSourceView classe implementa o método herdado ExecuteDelete para excluir dados de um banco de dados. Desenvolvedores de páginas e autores de controle associados a dados não chamam o ExecuteDelete método diretamente; em vez disso, use o método exposto Delete publicamente.

Os valores contidos na keys coleção são avaliados e mesclados com quaisquer valores contidos na DeleteParameters coleção. Se a ConflictDetection propriedade for definida como o CompareAllValues valor , os valores contidos na oldValues coleção serão formatados com a OldValuesParameterFormatString propriedade e também serão mesclados.

Antes que a operação de exclusão seja executada, o OnDeleting método é chamado para acionar o Deleting evento. Você pode manipular esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma exclusão.

Para executar uma operação de exclusão, o SqlDataSourceView objeto cria um DbCommand objeto usando o DeleteCommand texto e quaisquer propriedades associadas DeleteParameters e, em seguida, executa o DbCommand objeto no banco de dados subjacente. Após a conclusão da operação de exclusão, o OnDeleted método é chamado para acionar o Deleted evento. Você pode manipular esse evento para examinar quaisquer valores retornados e códigos de erro e para executar qualquer pós-processamento.

Aplica-se a

Confira também