SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa uma operação de exclusão usando a DeleteCommand cadeia de caracteres SQL, todos os parâmetros especificados na DeleteParameters coleção e os valores especificados keys e oldValues coleções.
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 -> intProtected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As IntegerParâmetros
- keys
- IDictionary
Um IDictionary dos valores de chave de linha ou objeto para a ExecuteDelete(IDictionary, IDictionary) operação a ser excluída.
- oldValues
- IDictionary
Um IDictionary que contém valores de linha que são avaliados somente se a ConflictDetection propriedade estiver definida como o CompareAllValues valor.
Retornos
Um valor que representa o número de linhas excluídas do banco de dados subjacente.
Exceções
Não SqlDataSource é possível estabelecer uma conexão com a fonte de dados subjacente.
- ou -
A ConflictDetection propriedade é definida como o CompareAllValues valor e nenhum oldValues parâmetro é passado.
O usuário atual não tem as permissões corretas para acessar o banco de dados.
- ou -
A instância do controle é um AccessDataSource controle e o acesso é negado ao caminho especificado para a DataFile propriedade.
A propriedade CanDelete é false.
- ou -
Um caminho relativo em tempo de design não foi mapeado corretamente pelo designer antes de usar uma instância do AccessDataSource controle.
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 lidar com esse evento para examinar quaisquer valores retornados e códigos de erro e executar qualquer pós-processamento.
