ObjectDataSourceView.ExecuteUpdate 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 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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParâ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
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
A propriedade CanInsert retorna false.
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.
