DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metodo

Definizione

Esegue un'operazione di aggiornamento sull'elenco di dati rappresentato dall'oggetto DataSourceView.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

Parametri

keys
IDictionary

Insieme IDictionary delle chiavi degli oggetti o delle righe da aggiornare tramite l'operazione di aggiornamento.An IDictionary of object or row keys to be updated by the update operation.

values
IDictionary

Insieme IDictionary delle coppie nome/valore che rappresentano gli elementi di dati e i relativi nuovi valori.An IDictionary of name/value pairs that represent data elements and their new values.

oldValues
IDictionary

Insieme IDictionary delle coppie nome/valore che rappresentano gli elementi di dati e i relativi valori originali.An IDictionary of name/value pairs that represent data elements and their original values.

Restituisce

Il numero di elementi aggiornati nell'archivio dati sottostante.The number of items that were updated in the underlying data storage.

Eccezioni

Esempi

Nell'esempio di codice seguente viene illustrato il modo in cui DataSourceView una classe che estende CanUpdate la classe può ExecuteUpdate eseguire l'override della proprietà e del metodo.The following code example demonstrates how a class that extends the DataSourceView class can override the CanUpdate property and the ExecuteUpdate method. Questo esempio di codice fa parte di un esempio più ampio fornito DataSourceView per la 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

Commenti

I controlli con associazione a dati possono determinare ExecuteUpdate se l'operazione è supportata da un controllo origine dati tramite DataSourceControl.GetView il metodo per recuperare DataSourceView l'oggetto e controllare il valore della CanUpdate proprietà.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.

Il keys parametro rappresenta le chiavi degli oggetti o delle righe dei dati da aggiornare.The keys parameter represents the object or row keys of the data to update. Per le origini dati che rappresentano dati relazionali, ad esempio SqlDataSource il controllo, keys il parametro è una raccolta di chiavi primarie del database.For data sources that represent relational data, such as the SqlDataSource control, the keys parameter is a collection of database primary keys. In altri scenari, il keys parametro è una raccolta di coppie nome/valore e viene usato per filtrare un elenco di dati.In other scenarios, the keys parameter is a collection of name/value pairs and is used to filter a list of data. Tutti i dati corrispondenti a una coppia nome/valore vengono aggiornati con i valori trovati values nel parametro, ovvero un set di coppie nome/valore che rappresenta nuovi valori per i campi o le colonne esistenti.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.

Nota

L' DataSourceView implementazione predefinita della classe consiste nel generare un' NotSupportedException eccezione.The DataSourceView class's default implementation is to throw a NotSupportedException exception. Se si estende la DataSourceView classe, eseguire l' ExecuteUpdate override del metodo se la classe supporta l'aggiornamento dei dati nell'archivio dati sottostante.If you extend the DataSourceView class, override the ExecuteUpdate method if your class supports updating data in the underlying data storage.

Si applica a

Vedi anche