ObjectDataSourceView.ExecuteUpdate 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 atualização chamando o método identificado pela UpdateMethod propriedade e usando quaisquer parâmetros fornecidos nas keyscoleções, 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
Uma IDictionary de chaves primárias para usar com a UpdateMethod propriedade para realizar a operação de atualização da base de dados. Se não houver chaves associadas ao método, passe null.
- values
- IDictionary
A IDictionary de valores a serem usados com o UpdateMethod para realizar a operação de atualização da base de dados. Se não houver parâmetros associados ao método, passe null.
- oldValues
- IDictionary
A IDictionary que representa os valores originais no armazenamento de dados subjacente. Se não houver parâmetros associados à consulta, passe null.
Devoluções
O número de linhas atualizadas; ou -1, se o número não for conhecido. Para obter mais informações, veja Update().
Exceções
A CanInsert propriedade devolve false.
oldValues é null ou vazio e ConflictDetection é definido como CompareAllValues.
Observações
A ObjectDataSourceView classe implementa o método herdado ExecuteUpdate para atualizar dados usando um objeto de negócio. Os programadores de páginas e os autores de controlo encadernados por dados não chamam diretamente o ExecuteUpdate método; em vez disso, utilizam o método exposto Update publicamente.
Os valores contidos nas keys coleções e values são avaliados e fundidos com quaisquer valores contidos pela UpdateParameters 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 da operação de atualização ser realizada, o OnUpdating método é chamado para levantar o Updating evento. Pode gerir este evento para examinar os valores dos parâmetros e realizar qualquer pré-processamento antes de uma atualização. Para realizar uma operação de atualização, usa ObjectDataSourceView a reflexão para chamar o método identificado pela UpdateMethod propriedade e quaisquer parâmetros associados na keys coleção, e depois executa-o. Após a conclusão da operação, o OnUpdated método é chamado para elevar o Updated evento. Pode gerir este evento para examinar quaisquer valores de retorno, códigos de erro e realizar qualquer pós-processamento.
Para mais informações sobre como devolver o número de linhas atualizadas, veja Update.