ObjectDataSourceView.ExecuteUpdate Método

  • Referência

Definição

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

Executa uma operação de atualização chamando o método identificado pela propriedade UpdateMethod e usando parâmetros fornecidos nas coleções keys, values ou oldValues.

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 UpdateMethod para executar a operação de atualização do banco de dados. Se não houver nenhuma chave associada ao método, passe null.

values
IDictionary

Um IDictionary de valores a serem usadas com o UpdateMethod para executar a operação de atualização do banco de dados. Se não houver nenhum parâmetro associado ao método, passe null.

oldValues
IDictionary

Um IDictionary que representa os valores originais no armazenamento de dados subjacente. Se não houver nenhum parâmetro associado à consulta, passe null.

Retornos

Int32

O número de linhas atualizadas; ou -1, se o número não for conhecido. Para obter mais informações, consulte Update().

Exceções

NotSupportedException

A propriedade CanInsert retorna false.

InvalidOperationException

oldValues é null ou vazio e ConflictDetection está definido como CompareAllValues.

Comentários

A ObjectDataSourceView classe implementa o método herdado ExecuteUpdate para atualizar dados usando um objeto de negócios. 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 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 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 uma operação de atualização, o ObjectDataSourceView usa reflexão para chamar o método identificado pela UpdateMethod propriedade e quaisquer parâmetros associados na coleção e, em seguida, executa-o keys . 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, códigos de erro e executar qualquer pós-processamento.

Para obter mais informações sobre como retornar o número de linhas atualizadas, consulte Update.

Aplica-se a

Confira também