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

Definição

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.Performs an update operation using the UpdateCommand SQL string, any parameters that are in the UpdateParameters collection, and the values that are in the specified keys, values, and oldValues collections.

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.An IDictionary of primary keys to use with the UpdateCommand property to perform the update database operation. Se não existem chaves associadas à consulta ou se a propriedade UpdateCommand não é uma consulta SQL parametrizada, passa null.If there are no keys associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass 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.An IDictionary of values to use with the UpdateCommand property to perform the update database operation. Se não existem parâmetros associados à consulta ou se o UpdateCommand não é uma consulta SQL parametrizada, passa null.If there are no parameters associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

oldValues
IDictionary

Um IDictionary que representa os valores originais no banco de dados.An IDictionary that represents the original values in the database. Se não existem parâmetros associados à consulta ou se a propriedade UpdateCommand não é uma consulta SQL parametrizada, passa null.If there are no parameters associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass null.

Retornos

Int32

Um valor que representa o número de linhas atualizadas no banco de dados subjacente.A value that represents the number of rows updated in the underlying database.

Exceções

O SqlDataSource não pode estabelecer uma conexão com a fonte de dados subjacente.The SqlDataSource cannot establish a connection with the underlying data source.

- ou --or- A propriedade ConflictDetection é definida como o valor CompareAllValues e nenhum parâmetro oldValues é passado.The ConflictDetection property is set to the CompareAllValues value and no oldValues parameters are passed.

O usuário atual não tem as permissões corretas para obter acesso ao banco de dados.The current user does not have the correct permissions to gain access to the database.

A propriedade CanUpdate é false.The CanUpdate property is false.

Comentários

A SqlDataSourceView classe implementa o método herdado ExecuteUpdate para atualizar dados em um banco de dado.The SqlDataSourceView class implements the inherited ExecuteUpdate method to update data in a database. Os desenvolvedores de páginas e os autores de controle vinculado a dados não chamam o ExecuteUpdate método diretamente; em vez disso, use o método publicamente exposto Update .Page developers and data-bound control authors do not call the ExecuteUpdate method directly; instead, use the publicly exposed Update method.

Os valores contidos nas keys coleções e values são avaliados e mesclados com quaisquer valores contidos na UpdateParameters coleção.The values contained in the keys and values collections are evaluated and merged with any values contained by the UpdateParameters collection. Se a ConflictDetection propriedade for definida como CompareAllValues , os valores contidos na oldValues coleção serão formatados com o OldValuesParameterFormatString e também mesclados.If the ConflictDetection property is set to CompareAllValues, the values contained in the oldValues collection are formatted with the OldValuesParameterFormatString and also merged.

Antes que a operação de atualização seja executada, o OnUpdating método é chamado para gerar o Updating evento.Before the update operation is performed, the OnUpdating method is called to raise the Updating event. Você pode manipular esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma atualização.You can handle this event to examine the values of the parameters and perform any preprocessing before an update.

Para executar a operação, o SqlDataSourceView cria um DbCommand objeto usando o UpdateCommand texto e todas as UpdateParameters propriedades associadas e, em seguida, executa o DbCommand objeto no banco de dados subjacente.To perform the operation, the SqlDataSourceView builds a DbCommand object using the UpdateCommand text and any associated UpdateParameters properties, and then executes the DbCommand object against the underlying database. Após a conclusão da operação, o OnUpdated método é chamado para gerar o Updated evento.After the operation completes, the OnUpdated method is called to raise the Updated event. Você pode manipular esse evento para examinar quaisquer valores de retorno e códigos de erro e executar qualquer pós-processamento.You can handle this event to examine any return values and error codes and to perform any post-processing.

Aplica-se a

Confira também