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

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

Devoluções

O número de itens que foram atualizados no armazenamento de dados subjacente.

Exceções

Exemplos

O exemplo de código seguinte demonstra como uma classe que estende a DataSourceView classe pode sobrepor a CanUpdate propriedade e o ExecuteUpdate método. Este exemplo de código faz parte de um exemplo maior fornecido para a DataSourceView classe.

// 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

Observações

Os controlos limitados por dados podem determinar se a ExecuteUpdate operação é suportada por um controlo de fonte de dados usando o DataSourceControl.GetView método para recuperar o DataSourceView objeto e verificando o valor da CanUpdate propriedade.

O keys parâmetro representa o objeto ou as chaves de linha dos dados a atualizar. Para fontes de dados que representam dados relacionais, como o SqlDataSource controlo, o keys parâmetro é uma coleção de chaves primárias da base de dados. Noutros cenários, o keys parâmetro é uma coleção de pares nome/valor e é usado para filtrar uma lista de dados. Qualquer dado que corresponda a um par nome/valor é atualizado com os valores encontrados no values parâmetro, que é um conjunto de pares nome/valor que representa novos valores para campos ou colunas existentes.

Ver também

• CanUpdate