SqlDataSourceView.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 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.