DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> intProtected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParametri
- 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
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.
