SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 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.
Executa uma operação de atualização usando a UpdateCommand string SQL, quaisquer parâmetros que estejam na UpdateParameters coleção e os valores que estejam nas colecções especificadas keys, values, e 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 das chaves primárias para usar com a UpdateCommand propriedade para realizar a operação de atualização da base de dados. Se não existirem chaves associadas à consulta ou se a UpdateCommand propriedade não for uma consulta SQL parametrizada, passe null.
- values
- IDictionary
Um IDictionary de valores para usar com a UpdateCommand propriedade para realizar a operação de atualização da base de dados. Se não houver parâmetros associados à consulta ou se não UpdateCommand for uma consulta SQL parametrizada, passe null.
- oldValues
- IDictionary
E IDictionary que representa os valores originais na base de dados. Se não houver parâmetros associados à consulta ou se a UpdateCommand propriedade não for uma consulta SQL parametrizada, passe null.
Devoluções
Um valor que representa o número de linhas atualizadas na base de dados subjacente.
Exceções
Não conseguem SqlDataSource estabelecer uma ligação com a fonte de dados subjacente.
-ou-
A ConflictDetection propriedade é definida para o CompareAllValues valor e nenhum oldValues parâmetro é passado.
O utilizador atual não tem as permissões corretas para aceder à base de dados.
A propriedade CanUpdate é false.
Observações
A SqlDataSourceView classe implementa o método herdado ExecuteUpdate para atualizar dados numa base de dados. 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 CompareAllValues, os valores contidos na oldValues coleção são formatados com e OldValuesParameterFormatString também 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 a operação, constrói SqlDataSourceView um DbCommand objeto usando o UpdateCommand texto e quaisquer propriedades associadas UpdateParameters , e depois executa o DbCommand objeto contra a base de dados subjacente. 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 e códigos de erro e realizar qualquer pós-processamento.