DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

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

Int32

Il numero di elementi aggiornati nell'archivio dati sottostante.

Eccezioni

NotSupportedException

L'operazione ExecuteUpdate(IDictionary, IDictionary, IDictionary) non è supportata dall'oggetto DataSourceView.

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.

Vedi anche

• CanUpdate