SqlDataSourceView.ExecuteUpdate(IDictionary, 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 atualização usando a UpdateCommand cadeia de caracteres SQL, todos os UpdateParameters parâmetros que estão na coleção e os valores especificados keyse valuesoldValues coleções.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParâmetros
- keys
- IDictionary
Uma IDictionary das chaves primárias a serem usadas com a UpdateCommand propriedade para executar a operação de atualização do banco de dados. Se não houver chaves associadas à consulta ou se a UpdateCommand propriedade não for uma consulta SQL parametrizada, passe null.
- values
- IDictionary
Um IDictionary dos valores a serem usados com a UpdateCommand propriedade para executar a operação de atualização do banco de dados. Se não houver parâmetros associados à consulta ou se a UpdateCommand consulta SQL não for parametrizada, passe null.
- oldValues
- IDictionary
Um IDictionary que representa os valores originais no banco de dados. Se não houver parâmetros associados à consulta ou se a UpdateCommand propriedade não for uma consulta SQL parametrizada, passe null.
Retornos
Um valor que representa o número de linhas atualizadas no 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 obter acesso ao banco de dados.
A propriedade CanUpdate é false.
Comentários
A SqlDataSourceView classe implementa o método herdado ExecuteUpdate para atualizar dados em um banco de dados. Desenvolvedores de páginas e autores de controle associados a dados não chamam o ExecuteUpdate método diretamente; em vez disso, use o método exposto Update publicamente.
Os valores contidos nas coleções e values são keys avaliados e mesclados com todos os valores contidos na UpdateParameters coleção. Se a ConflictDetection propriedade estiver definida como CompareAllValues, os valores contidos na oldValues coleção serão formatados com o OldValuesParameterFormatString e também mesclados.
Antes que a operação de atualização seja executada, o OnUpdating método é chamado para gerar o Updating evento. Você pode manipular esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma atualização.
Para executar a operação, o SqlDataSourceView objeto cria usando DbCommand o UpdateCommand texto e as propriedades associadas UpdateParameters e executa o DbCommand objeto no banco de dados subjacente. Após a conclusão da operação, o OnUpdated método é chamado para acionar o Updated evento. Você pode lidar com esse evento para examinar quaisquer valores retornados e códigos de erro e executar qualquer pós-processamento.
