Condividi tramite


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metodo

Definizione

Esegue un'operazione di aggiornamento sull'elenco di dati rappresentato dall'oggetto DataSourceView.

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

Parametri

keys
IDictionary

Insieme IDictionary delle chiavi degli oggetti o delle righe da aggiornare tramite l'operazione di aggiornamento.

values
IDictionary

Insieme IDictionary delle coppie nome/valore che rappresentano gli elementi di dati e i relativi nuovi valori.

oldValues
IDictionary

Insieme IDictionary delle coppie nome/valore che rappresentano gli elementi di dati e i relativi valori originali.

Restituisce

Il numero di elementi aggiornati nell'archivio dati sottostante.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come una classe che estende la DataSourceView classe può eseguire l'override della CanUpdate proprietà e del ExecuteUpdate metodo . Questo esempio di codice fa parte di un esempio più ampio fornito per la 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

Commenti

I controlli associati a dati possono determinare se l'operazione ExecuteUpdate è supportata da un controllo origine dati usando il DataSourceControl.GetView metodo per recuperare l'oggetto DataSourceView e controllare il valore della CanUpdate proprietà.

Il keys parametro rappresenta le chiavi dell'oggetto o della riga dei dati da aggiornare. Per le origini dati che rappresentano dati relazionali, ad esempio il SqlDataSource controllo , il keys parametro è una raccolta di chiavi primarie del database. In altri scenari, il keys parametro è una raccolta di coppie nome/valore e viene usato per filtrare un elenco di dati. Tutti i dati corrispondenti a una coppia nome/valore vengono aggiornati con i valori trovati nel values parametro , ovvero un set di coppie nome/valore che rappresenta nuovi valori per i campi o le colonne esistenti.

Nota

L'implementazione DataSourceView predefinita della classe consiste nell'generare un'eccezione NotSupportedException . Se si estende la classe, eseguire l'override DataSourceView del ExecuteUpdate metodo se la classe supporta l'aggiornamento dei dati nell'archivio dati sottostante.

Si applica a

Vedi anche