SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Método

Definição

Realiza uma operação de eliminação usando a DeleteCommand string SQL, quaisquer parâmetros especificados na DeleteParameters coleção e os valores que estejam nas colecções e oldValues especificadoskeys.

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 de valores-chave de objeto ou linha para a ExecuteDelete(IDictionary, IDictionary) operação eliminar.

oldValues
IDictionary

E IDictionary que contém valores de linha que só são avaliados se a ConflictDetection propriedade estiver definida para o CompareAllValues valor.

Devoluções

Um valor que representa o número de linhas eliminadas da base de dados subjacente.

Exceções

Não conseguem SqlDataSource estabelecer uma ligação com a fonte de dados subjacente.

-ou-

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

O utilizador atual não tem as permissões corretas para aceder à base de dados.

-ou-

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

A propriedade CanDelete é false.

-ou-

Um caminho relativo em tempo de projeto não foi mapeado corretamente pelo projetista antes de usar uma instância do AccessDataSource controlo.

Observações

A SqlDataSourceView classe implementa o método herdado ExecuteDelete para eliminar dados de uma base de dados. Os programadores de páginas e os autores de controlo encadernados por dados não chamam diretamente o ExecuteDelete método; em vez disso, utilizam o método exposto Delete publicamente.

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

Antes de a operação de eliminação ser executada, o OnDeleting método é chamado para levantar o Deleting evento. Pode gerir este evento para examinar os valores dos parâmetros e realizar qualquer pré-processamento antes de uma eliminação.

Para realizar uma operação de eliminação, o SqlDataSourceView objeto constrói um DbCommand objeto usando o DeleteCommand texto e quaisquer propriedades associadas DeleteParameters , e depois executa o DbCommand objeto contra a base de dados subjacente. Depois de concluída a operação de eliminação, o OnDeleted método é chamado para levantar o Deleted evento. Pode gerir este evento para examinar quaisquer valores de retorno e códigos de erro e realizar qualquer pós-processamento.

Aplica-se a

Ver também