SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Método

  • Referência

Definição

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

Executa uma operação de atualização usando a cadeia de caracteres SQL UpdateCommand, quaisquer parâmetros que estão na coleção UpdateParameters e os valores que estão nas coleções keys, values e oldValues especificadas.

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 -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parâmetros

keys
IDictionary

Um IDictionary de chaves primárias a serem usadas com a propriedade UpdateCommand para executar a operação de atualização do banco de dados. Se não existem chaves associadas à consulta ou se a propriedade UpdateCommand não é uma consulta SQL parametrizada, passa null.

values
IDictionary

Um IDictionary de valores a serem usados com a propriedade UpdateCommand para executar a operação de atualização do banco de dados. Se não existem parâmetros associados à consulta ou se o UpdateCommand não é uma consulta SQL parametrizada, passa null.

oldValues
IDictionary

Um IDictionary que representa os valores originais no banco de dados. Se não existem parâmetros associados à consulta ou se a propriedade UpdateCommand não é uma consulta SQL parametrizada, passa null.

Retornos

Int32

Um valor que representa o número de linhas atualizadas 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 obter acesso ao banco de dados.

NotSupportedException

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 keys coleções e values são avaliados e mesclados com quaisquer valores contidos na UpdateParameters coleção. Se a ConflictDetection propriedade for definida CompareAllValuescomo , 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 acionar 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 cria um DbCommand objeto usando o UpdateCommand texto e quaisquer propriedades associadas UpdateParameters e, em seguida, 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 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