ObjectDataSourceView.ExecuteUpdate 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 chiamando il metodo identificato dalla proprietà UpdateMethod e utilizzando tutti i parametri forniti negli insiemi keys, values o oldValues.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParametri
- keys
- IDictionary
Un oggetto IDictionary di chiavi primarie da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database. Se non esistono chiavi associate al metodo, passare null.
- values
- IDictionary
Un oggetto IDictionary di valori da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database. Se non esistono parametri associati al metodo, passare null.
- oldValues
- IDictionary
Un oggetto IDictionary che rappresenta i valori originali nell'archivio dati sottostante. Se non esistono parametri associati alla query, passare null.
Restituisce
Numero di righe aggiornate; oppure -1, se il numero non è noto. Per altre informazioni, vedere Update().
Eccezioni
La proprietà CanInsert restituisce false.
oldValues è null o vuoto e ConflictDetection è impostato su CompareAllValues.
Commenti
La ObjectDataSourceView classe implementa il metodo ereditato ExecuteUpdate per aggiornare i dati usando un oggetto business. Gli sviluppatori di pagine e gli autori di controlli associati ai dati non chiamano direttamente il metodo. Usare invece il ExecuteUpdate metodo esposto Update pubblicamente.
I valori contenuti nelle keys raccolte e vengono valutati e values uniti a tutti i valori contenuti dall'insieme UpdateParameters . Se la ConflictDetection proprietà è impostata sul CompareAllValues valore, i valori contenuti nella oldValues raccolta vengono formattati con la OldValuesParameterFormatString proprietà e vengono uniti.
Prima di eseguire l'operazione di aggiornamento, viene chiamato il OnUpdating metodo per generare l'evento Updating . È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un aggiornamento. Per eseguire un'operazione di aggiornamento, il ObjectDataSourceView metodo usa la reflection per chiamare il metodo identificato dalla UpdateMethod proprietà e tutti i parametri associati nella keys raccolta e quindi lo esegue. Al termine dell'operazione, il OnUpdated metodo viene chiamato per generare l'evento Updated . È possibile gestire questo evento per esaminare i valori restituiti, i codici di errore ed eseguire qualsiasi post-elaborazione.
Per altre informazioni sulla restituzione del numero di righe aggiornate, vedere Update.
