DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Método
Definição
Executa uma operação de atualização na lista de dados que o objeto DataSourceView representa.Performs an update operation on the list of data that the DataSourceView object represents.
protected:
virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
Parâmetros
- keys
- IDictionary
Um IDictionary de chaves de linha ou objeto a ser atualizado pela operação de atualização.An IDictionary of object or row keys to be updated by the update operation.
- values
- IDictionary
Um IDictionary de pares nome-valor que representa os elementos de dados e seus novos valores.An IDictionary of name/value pairs that represent data elements and their new values.
- oldValues
- IDictionary
Um IDictionary de pares nome-valor que representa os elementos de dados e seus valores originais.An IDictionary of name/value pairs that represent data elements and their original values.
Retornos
O número de itens que foram atualizados no armazenamento de dados subjacente.The number of items that were updated in the underlying data storage.
Exceções
Não há suporte para a operação ExecuteUpdate(IDictionary, IDictionary, IDictionary) pelo DataSourceView.The ExecuteUpdate(IDictionary, IDictionary, IDictionary) operation is not supported by the DataSourceView.
Exemplos
O exemplo de código a seguir demonstra como uma classe que estende a DataSourceView classe pode substituir a CanUpdate propriedade e o ExecuteUpdate método.The following code example demonstrates how a class that extends the DataSourceView class can override the CanUpdate property and the ExecuteUpdate method. Este exemplo de código faz parte de um exemplo maior fornecido para a DataSourceView classe.This code example is part of a larger example provided for the DataSourceView class.
// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
get {
return false;
}
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit update operations. You can modify or
' extend this sample to do so.
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
values As IDictionary, _
oldValues As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteUpdate
End Class
Comentários
Os controles vinculados a dados podem determinar se a ExecuteUpdate operação é suportada por um controle da fonte de dados usando o DataSourceControl.GetView método para recuperar o DataSourceView objeto e verificar o valor da CanUpdate propriedade.Data-bound controls can determine whether the ExecuteUpdate operation is supported by a data source control by using the DataSourceControl.GetView method to retrieve the DataSourceView object and checking the value of the CanUpdate property.
O keys parâmetro representa as chaves de objeto ou de linha dos dados a serem atualizados.The keys parameter represents the object or row keys of the data to update. Para fontes de dados que representam dados relacionais como, por exemplo SqlDataSource , o controle, o keys parâmetro é uma coleção de chaves primárias do banco de dado.For data sources that represent relational data, such as the SqlDataSource control, the keys parameter is a collection of database primary keys. Em outros cenários, o keys parâmetro é uma coleção de pares de nome/valor e é usado para filtrar uma lista de dados.In other scenarios, the keys parameter is a collection of name/value pairs and is used to filter a list of data. Todos os dados que correspondem a um par de nome/valor são atualizados com os valores encontrados no values parâmetro, que é um conjunto de pares de nome/valor que representa novos valores para campos ou colunas existentes.Any data matching a name/value pair is updated with the values found in the values parameter, which is a set of name/value pairs that represents new values for existing fields or columns.
Observação
A DataSourceView implementação padrão da classe é gerar uma NotSupportedException exceção.The DataSourceView class's default implementation is to throw a NotSupportedException exception. Se você estender a DataSourceView classe, substitua o ExecuteUpdate método se sua classe der suporte à atualização de dados no armazenamento de dados subjacente.If you extend the DataSourceView class, override the ExecuteUpdate method if your class supports updating data in the underlying data storage.